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DEFINITION OF TERMS 



active foreground program: a foreground program is active 
if it is resident in memory, connected to interrupts, or 
in the process of being entered into the system via a 
I RUN control command. 

addend value: a hexadecimal or decimal constant to be 
added to the value of a relocatable address. The con- 
stant is expressed as a signed integer appended to the 
address; e.g., START +12 or HERE-.F1. 

address resolution code: a 2-bit code that specifies whether 
an associated address is to be used as a byte address or 
is to be converted to a halfword, word, or doubleword 
address. 

background area: that area of core storage allocated to 
batch processing. This area may be checkpointed for 
use by foreground programs. 

background program: any program executed under Monitor 
control in the background area with no external inter- 
rupts active. These programs are entered through the 
batch processing input stream. 

binary input: input from the device to which the BI (binary 
input) operational label is assigned. 

centrally connected interrupt: an interrupt that is con- 
nected to a Monitor interrupt routine which first 
saves the environment of the system and then switches 
the environment to that of the task that gets control 
when the interrupt occurs. 

checkpointed job: a partially processed background job 
that has been saved in secondary storage along with 
all registers and other "environment" so that the job 
can be restarted. 

control command: any control message other than a key-in. 
A control command may be input via any device to 
which the system command input function has been 
assigned (normally a card reader). 

control message: any message received by the Monitor that 
is either a control command or a control key-in (see 

"key-in"). 

Data Control Block (DCB): a table in the executing pro- 
gram that contains the information used by the Monitor 
in the performance of an I/O operation. 

declaration: an object language load item that introduces 
a symbolic name, so that the loadercangive it a unique 
name number. 

declaration number: the name numbergiven to the symbolic 
external name associated with a particular object lan- 
guage declaration. 

dedicated memory: core memory locations reserved by the 
Monitor for special purposes, such as traps, interrupts, 
and real-time programs. 

directly connected interrupt: an interrupt which, when it 
occurs, causes control to go directly to the task, 
e.g., execution of the XPSD instruction in the interrupt 



location gives control to the task rather than first going 
to a Monitor interrupt routine. 

dummy section: a type of program section that provides a 
means by which more than one subroutine may reference 
the same data (via an external definition used as a 
label for the dummy section). 

end record: the last record to be loaded, in an object mod- 
ule or load module. 

error severity level code: a 4-bit code Indicating the sev- 
erity of errors noted by the processor. This code is 
contained in the final byte of an object module. 

execution location: a value replacing the origin of a relo- 
catable program, to change theaddressat which program 
loading is to begin. 

expression: a series of load items immediately preceded by 
an "origin", "define field", "forward reference defini- 
tion", "external definition", or "define start" load 
item and terminated by an "expression end" load item 
(see Appendix A). 

external definition: a load item that assigns a specific 
value to the symbolic name associated with a particular 
external definition name number. An external defini- 
tion allows the specified symbolic name to be used in 
external references (see below). 

external reference: a reference to a declared symbolic 
name that is not defined within the object module in 
which the reference occurs. An external reference 
can be satisfied only if the referenced name is defined 
by an external load item in another object module. 

foreground area: that portion of memory dedicated specifi- 
cally for foreground programs. 

foreground program: a load module that contains one or 
more foreground tasks. 

forward reference number: a number assigned by a processor 
to designate a specific forward reference in a source 
program. 

foreground task: a body of procedural code that is asso- 
ciated with (connected to) a particular interrupt and 
that is executed when the interrupt occurs. 

Function Parameter Table (FPT): a table through which a 
user's program communicates with a Monitor function 
(such as an I/O function). 

GO file: a temporary RAD file of Relocatable Object 
Modules formed by a processor. 

granule: a block of disc sectors containing a specified 
number of words. 

idle state: the state of the Monitor when it is first loaded 
into core memory or after encountering a I FIN control 
command. The idle state is ended by means of a !C 
key-in. 



installation control command: any control command used 
during System Generation to direct the formatting of 
a Monitor system. 

key-in: information entered by the operator via a keyboard. 

keyword: a word, consisting of from 1 to 8 characters, that 
identifies a particularoperand used ina control command. 

library input: input from the device to which the LI (library 
input) operational label is assigned. 

load item: a load control byte followed by any additional 
bytes of load information pertaining to the function 
specified by the control byte. 

load location counter: a counter established and maintained 
to contain the address of the next location into which 
information is to be loaded. 

load map: a listing of significant information pertaining to 
the storage locations used by a program. 

load module: an executable program formed by using relo- 
catable object modules and/or library object modules 
as source information. 

logical device: a peripheral device that is represented in a 
program by an operational label (e.g. , BI or BO) rather 
than by a specific physical device name. 

Monitor: a program that supervises the processing, loading, 
and execution of other programs. 

name number: a number assigned by the relocating loader 
to identify a declared name. 

object deck: a card deck comprising one or more object 
modules and control commands. 

object language: the standard binary language in which the 
output of a compiler or assembler is expressed. 

object module: the series of records containing the load in- 
formation pertaining to a single program or subprogram. 
Object modules serve as input to the Overlay Loader. 

operational label: a symbolic name used to identify a logi- 
cal system device. 

option: an elective operand in a control command or pro- 
cedure call, or an elective parameter in a Function 
Parameter Table. 

OV file: is a temporary RAD file that contains an exe- 
cutable program formed by the Overlay Loader if a 
program file name was not specified at load time. 
Used primarily to test new programs or new versions 
of programs. 

Overlay Loader: a processor that loads and links elements 
of overlay programs. 

overlay program: a segmented program in which the segment 
currently being executed may overlay the core storage 
area occupied by a previously executed segment. 

parameter presence indicator: a bit, in word 1 of a Func- 
tion Parameter Table that indicates whether a particu- 
lar parameter word is present in the remainder of the 
table. 



physical device: a peripheral device that is referred to by 
a "name" specifying the device type, I/O channel, 
and device number (also see "logical device"). 

postmortem dump: a listing of the contents of a specified 
area of core memory, usually following the abortive 
execution of a program. 

primary reference: an external reference that must be satis- 
fied by a corresponding external definition (capable of 
causing loading from the system library). 

Program Trap Conditions (PTC): two words that indicate 
trap status (set or reset) and trap exit address, 
respectively. 

pseudo file name: a symbolic name used to identify a logi- 
cal device in a user's program. 

Relocatable Object Module: a program, or subprogram, 
generated by a processor such as Macro-Symbol, 
FORTRAN, etc. (in XDS Sigma 5/7 object language). 

resident program: a program that has been loaded into a 
dedicated area of core memory. 

ROM: Relocatable Object Module. 

secondary reference: an external reference that may or 
may not be satisfied by a corresponding external 
definition (not capable of causing loading from the 
system library). 

secondary storage: any rapid-access storage medium other 
than core memory (e.g., RAD). 

segment loader: a Monitor routine that loads overlay seg- 
ments from disc storage at execution time. 

source deck: a card deck comprising a complete program 
or subprogram, in symbolic EBCDIC format. 

source language: a language used to prepare a source pro- 
gram (and therefrom a source deck) suitable for pro- 
cessing by an assembler or compiler. 

standard control section: a control section whose length is 
not known by a 1-pass processor until all the load in- 
formation for that section has been generated. 

symbolic input: input from the device to which the SI 
(symbolic input) operational label is assigned. 

symbolic name: an identifier that is associated with some 
particular source program statement or item so that 
symbolic references may be made to it even though its 
value may be subject to redefinition. 

system library: a group of standard routines in object- 
language format, any of which may be included in a 
program being created. 

Task Control Block (TCB): a table of program control infor- 
mation built by the relocating loader when a load module 
is formed. The TCB is part of the load module and con- 
tains a tempstackand the data required to allow reentry 
of library routines during program execution. The TCB 
is program associated and not task associated. 

Temp Stack: a push-down stack created by the Overlay Loader 
and used by the Monitor and System Library routines. 



1. INTRODUCTION 



OPERATING SYSTEM 

The Sigma 5/7 Real-Time Batch Monitor (RBM) is the major 
control element in an installation's operation system. Op- 
erating in a real-time environment, the Monitor provides 
for concurrent background/foreground processing with em- 
phasis on foreground operations. 

The operating system consists of the Monitor, language 
translators, service programs, batch (background) user's pro- 
grams, and real-time (foreground) user's programs. In gen- 
eral, the Monitor governs the order in which these programs 
are executed and provides services common to all of them. 

The number, types, and version of programs in an operating 
system vary, depending upon the exact requirements at a 
particular installation. Each operating system consists of 
closely integrated Monitor routines and processing programs 
for a given range of applications. 

As the requirements of an installation increase, the oper- 
ating system can be enlarged, modified, or updated. The 
ability to adapt to new requirements is inherent in the sys- 
tem design. Once a system is generated, it can quickly 
be expanded to include users' programs, data, and system 
libraries. 

A user's program and data may be temporarily incorporated 
in the operating system or remain a part of the system for an 
extended period of time. 

The operating system is self-contained and requires operator 
intervention only under exceptional conditions. Operating 
procedures are given in fheXDS Sigma 5/7 Real-Time Batch 
Monitor Operations Manual. 

RBM TERMS AND PROCESSES 

The following items are either unique to the RBM system or 
have specific meaning within the RBM context. Terms and 
processes not defined below are fully explained in the ap- 
propriate chapter. 

TASK 

A task is a body of foreground procedural code associated 
with a specific interrupt. 

PROGRAM 



FOREGROUND 

The foreground is the set of all tasks in the system that are 
currently connected to external interrupts. The priority 
level and activation sequence of each interrupt controls the 
execution order of the tasks. Foreground tasks are guaran- 
teed memory protection from background processes. 

BACKGROUND 

The background is the set of all programs that use up any 
available CPU time after the real-time interrupts are satis- 
fied. In contrast to foreground tasks, background programs 
are executed serially and their sequence is controlled by 
control commands. 

TEMP STACK 

The Temp Stack is a "push-down/pull-up" stack of memory 
locations allocated by the Overlay Loader. It is used for 
dynamic temporary storage when Monitor functions and 
FORTRAN IV-H Library subroutines are called, and is also 
available as temporary storage for the user. 

DATA CONTROL BLOCK 

A DCB is a table located in the calling program that con- 
tains information used by RBM in the performance of an I/O 
operation. DCBs are the means by which I/O information 
is communicated between a user's program and the Monitor. 
The information required for a particular I/O operation is 
either contained in the associated DCBor is given in a cal I. 
The specific information needed for an I/O operation de- 
pends on the organization of the data involved and the type 
of operation to be performed. 

The device used for an I/O operation is determined by the 
contents of the associated DCB when the I/O operation is 
requested by the executing program. 

There are both system DCBs and user-created DCBs. The 
system DCBs need only be coded as external references in a 
System Processor or user program; the Overlay Loader will 
satisfy these external references at load time by furnishing 
a copy of the appropriate DCBs in the program's root. If a 
user is not satisfied with the standard DCB parameters fur- 
nished by the Overlay Loader, the system DCBs can be coded 
into the user program's root and the DCB name declared as 
an external definition. 

FUNCTION PARAMETER TABLE 



A program is a body of procedural code and data that Is 
identifiable by name. A program is created at load time 
from object modules and exists after load time in core image 
form. A program is identified by a name so that it may be 
loaded or released on request. Background programs are 
loaded by control commands; foreground programs can be 
loaded or released upon request through operator key-in, 
control command, or system call from a foreground task. 



An FPT is a table through which a program communicates 
with a Monitor function. 

TASK CONTROL BLOCK 

A TCB is a table containing task-associated parameters. 
The space for this table is allocated by the user and the 
entries are used and maintained by the Monitor. 
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PROGRAM CONTROL BLOCK 

The PCB is a fable containing program-associated param- 
eters. The PCB is constructed by the Overlay Loader at 
load time. 

CHECKPOINT 

Checkpoint is the function of saving a copy of the back- 
ground program on secondary storage. 

RESTART 

Restart is the function of restoring a background program 
from its checkpoint image and resuming its operation from 
the point of interruption. 

REENTRANT SUBROUTINE 



The Monitor provides foreground programs with the facility 
for direct I/O operations (so-called IOEX operations), 
wherein the user furnishes the basic hardware commands and 
does the necessary error checking and recovery. This type 
of I/O operation provides decreased overhead and greater 
flexibility as compared to indirect I/O operations. 

Foreground programs can be loaded for execution from a 
background job stack by operator key-in or through a system 
call by a foreground program, providing the program to be 
loaded is already on the RAD in core image format. Fore- 
ground programs are responsible for initializing the interrupt 
system and connecting tasks to interrupts. Foreground tasks 
can be processed compatibly and concurrently with a back- 
ground production job stack. 

RBM will not borrow CPU time from a higher priority task to 
process I/O requests of a lower priority. 



A reentrant subroutine can be called by several different 
tasks. During execution of such a subroutine, a higher pri- 
ority task can interrupt and call the same subroutine. When 
the higher priority task has completed execution, control is 
returned to the subroutine at the interrupted point. Since 
a reentrant subroutine does not perform any instruction 
modification and uses the Temp Stack for scratch storage, 
processing continues as though the subroutine had never 
been reentered. 

PHILOSOPHY OF OPERATION 

The Monitor provides for two levels of operation: 

1. Real-time foreground processing. 

2. Batch processing. 

REAL-TIME PROCESSING 

Real-time processing, the mostcritical aspect of multiusage, 
involves reacting to external events (includingclock pulses) 
within microseconds. 

Real-Time programs can be either automatically loaded 
every time the system is booted from the RAD or loaded 
and initiated as needed. The first method is used when the 
real-time process normally remains unchanged and is con- 
stantly operative. The second approach is used when real- 
time operations are executed periodically or irregularly, as 
in an experimental laboratory. 

A real-time process is assigned machine facilities on a ded- 
icated basis at installation time. These facilities include 
RAD and core memory residency, I/O channels, peripheral 
devices, and external interrupt lines. Such allocation re- 
mains in force until either the process or the computer oper- 
ator terminates the program. 

During SYSGEN, a user can reserve a portion of his fore- 
ground area for communication between real-time programs. 
Locations in this area are called foreground mailboxes. The 
start of this area can be referenced through the system label 
FP:MBOX. Upon encountering an external reference to 
FP:MBOX, the Overlay Loader will satisfy the reference 
with the first location in the mailbox area. 



BATCH PROCESSING 

The system is capable of processing a continuous series of 
background jobs with little or no operator intervention. 
Reducing the need for operator participation ensures faster 
throughput, makes operations less subject to error, and 
allows the operator to perform other tasks. 



MONITOR 

The Monitor controls and coordinates batch (background) 
and real-time (foreground) processing. Efficient operation 
is assured by minimizing Monitor overhead in response to 
an interrupt, and by preserving the relative priority of 
tasks. 

Reentrant service functions perform I/O and control the in- 
terrupt system; other service functions load and connect 
foreground tasks, and control the partition of memory be- 
tween foreground and background areas. 

The Monitor provides for dynamic partitioning of core mem- 
ory into background and foreground areas under user control. 

Parts of the Monitor must remain resident to ensure continu- 
ous coordinated operation. Other parts are brought into 
core memory from secondary storage as required to perform 
specific functions. Secondary storage management is essen- 
tial for the Monitor. It is used for system storage to overlay 
portions of the Monitor, thus minimizing core memory resi- 
dency. Processing programs are retrieved from the RAD and 
they too can capitalize on overlay techniques to minimize 
core memory requirements. 

Scratch storage for service programs, processors, and user 
programs is available on the RAD. In addition, the secon- 
dary storage accommodates permanent user files. Permanent 
user fi les on disc are provided through the RAD Editor, which 
can allocate files on the RAD in addition to providing media 
conversion, RAD mapping (listing of files), and other services. 

The Monitor provides foreground programs with a background 
checkpoint feature that writes the background program on 
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the RAD (after the I/O requests outstanding at the time of 
the checkpoint requests have completed) and marks the 
background core as foreground. The checkpoint of the 
background is performed implicitly when a request is made 
to load a foreground program and some portion of the mem- 
ory occupied by the program lies in the background area. 
The restart of the checkpoinfed background is also per- 
formed implicitly upon release of the last foreground pro- 
gram using a portion of the memory area required by the 
checkpointed program. 

Monitor features are summarized as follows: 

• Efficient I/O service to user programs. 

• Dynamic real-time process initiation and execution. 

• Utilization and management of rapid-access secondary 
storage (RAD). 

• Comprehensive control of system operation by computer 
operator. 

• Sophisticated (but easy-to-use) processor services for 
program creation and execution such as FORTRAN IV-H 
and Macro-Symbol. 

• Checkpoint service. 

• Job accounting. 

• Flexible job scheduling of foreground programs for 
efficient throughput operation and recognition of in- 
stallation priorities. 

• Modular, flexible design for user modification. 

• Use of overlay techniques and Public Library capability 
to minimize core memory residency. 

• Blocking and compression of RAD files. 

• Foreground priority scheduling. 

• Direct I/O operations. 

• Memory protection of the operating environment and 
real-time processes (except for read protection). 

RAD UTILIZATION 

A rapid access disc (RAD) is essential for efficient operation 
of the Monitor. It minimizes core memory requirements by 
storing all Monitor, processor, and user program overlays, 
yet provides very fast access whenever an overlay is called 
into memory. 

RAD FILES 

During System Generation, the RAD(s) is divided into large 
blocks called RAD areas. These areas represent functional 
groupings of RAD files. All RAD files within an area are 
either temporary or permanent, and have the same software 



write protection. Since the entire RBM system is RAD 
oriented, every job will directly or indirectly involve the 
use, modification, allocation, or release of RAD files. 
Listed below are the RAD areas and the types of files that 
occupy them. 

• Foreground Programs area (FP) contains a collection of 
foreground programs and optional User Libraries and 
Public Libraries. Reference library routines are in- 
cluded in the user load modules at "load time". Public 
Libraries are a group of routines shared by a number of 
programs and are called into core for execution only 
when referenced. 

• System Programs area (SP) contains the Monitor and the 
set of language translators used by the local insral lation, 
such as Macro-Symbol and FORTRAN IV-H. The area 
also contains the System Library (i.e., FORTRAN IV-H 
Library /Run-time), RAD Editor, and Overlay Loader. 
All translators are called by user jobs to execute in the 
background core space. 

• Background Programs area (BP) contains the set of user 
operational programs that execute in the background, 
a n d a baeli g fa uwd Uco i 1 Lib i u i j if uui i i.il. 

• Data areas (Dl through DF)are divided into foreground 
and background data areas, and are used for storing 
data. Foreground programs cannot write into files in 
background data areas or vice versa; however, either 
type of program can freely read from both areas. 

• Background Temp area (BT) contains temporary (scratch) 
files (XI through Xn where n is a SYSGEN parameter) 
used by background programs for intermediate storage 
in processing. Their use is identical to scratch tapes 
on magnetic tape units. (Note that temp files are,- i,r 
destroyed at the end of each job step .unless » iffW/E 
c fc mm a n a i c p rcaer il i mT l n i ru f up'sfr e pi j Temp riles are 
automatically destroyed when a new I JOB command is 
encountered in a job stack regardless of :SAVE com- 
mands, and there is no way to save data on temp files 
from one job to another. 

The GO and OV files are also temporary files in the BT 
area but have more permanence than the Xi temp files. The 
GO file contains Relocatable Object Modules (ROMs) 
formed by a processor if the GO option was specified on a 
control command. It is used by FORTRAN IV-H, Macro- 
Symbol, and Symbol programs for assemble-and-go type of 
operations. The OV file contains the executable program 
formed by the Overlay Loader if a program file name was 
not specified at load time. It is the default output file for 
the Overlay Loader, and is used primarily to test a new 
program that has no permanent file defined, or to test a new 
version of a program without destroying the current version. 
A program in the OV file is always named OV, and is 
called for execution via an !ROV control command. 

Note that both GO and OV are used for communication 
between job steps but not jobs. There is no Monitor pro- 
tection for these files between one job and another. 
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JOB ACCOUNTING 

The Monitor provides accounting services for user job activ- 
ity on the Sigma computer. Because of the system's multi- 
usage capability, the accounting information can indicate 
total elapsed time or actual machine time of each job. 

Background jobaccounting isan option selected at SYSGEN. 
To correctly calculate the elapsed time of a background job, 
all foreground tasks need to be centrally connected (see 
"Connecting Real-Time Tasks to Interrupts" in Chapter 4). 
Otherwise, the foreground task's execution time will be in- 
cluded in the elapsed time of the background job. 

To prevent including foreground execution time with back- 
ground elapsed time, foreground response time to an inter- 
rupt will be slightly slower (5 microseconds). However, at 
SYSGEN, the user has the option to include foreground 
execution time with background elapsed time to prevent 
this degradation of foreground response time. 

At the beginning of a background job, the date and start 
time (in hours and minutes) wi 1 1 be logged on the LL device. 
At the end of a background job, the total time of the job 
(in hours, minutes, and seconds) will also be logged on LL. 
This information plus the account number and user name is 
then written on the M AL" file in the Background Data area 
of the RAD. The "AL" file must be defined via the RAD 
Editor; it must be in the Dl area of the RAD, and allocated 
a minimum size of 256 words. This file can be purged 
periodically by the operator. 

The total time of a job is computed from the time the ! JOB 
command is read until the next ! JOB or !FIN command is 
encountered. Following the !F1N command and until the 
next !JOB command, all unused time is charged to the idle 
account. 

To attach a date and time to each job, the user is required 
to input the date and time of day (to the nearest minute) 
whenever the system is booted into core. 

PUBLIC LIBRARY 

If an RBM system has several programs that share a group of 
subroutines, this set of subroutines can be collected in core 
in a "public library". This preselected set is loaded by the 
Overlay Loader into a previously defined file on the RAD. 
The Loader also writes the names and entry points of all the 
routines into the same RAD file. Then, whenever the Over- 
lay Loader loads a foreground or background program that 
references one of the "public" routines, it links up the 
appropriate branch to the Public Library copy instead of 
loading a separate copy. This can represent a considerable 
saving in space for a large system. 

If the appropriate Public Library was not already present in 
core, it will be automatically loaded into its specified fore- 
ground location whenever a program is loaded that uses it. 
Routines in the Public Library will execute under the same 
WRITE key as the calling program; therefore, a Public 
Library routine used by both foreground and background 
must only store into the calling program area. 



RBM CONTROL TASK 

The RBM Control Task will perform the following functions: 

1. "I/O cleanup" and "I/O start" when any of these 
functions are deferred from the I/O interrupt task be- 
cause of priority considerations. 

2. Loading and initialization of foreground programs and 
loading of background programs. 

3. Release of foreground and background programs. 

4. Console interrupt and operator key-in processing. 

5. Postmortem dumps for the background. 

6. Checkpoint and restart of background. 

The RBM Control Task is connected to the lowest priority 
interrupt in the system at System Generation time. For con- 
figurations without system interrupts, the Control Task is 
connected to the console interrupt. 

OVERLAYS 

RBM is overlayed to minimize core residence requirements. 
The overlays consist of all Control Task subtasks such as the 
various key-in processors. 

Foreground functions and frequent-use functions are all 
resident. 

MEMORY PROTECTION 

The Monitor provides memory protection for all input oper- 
ations, except direct input and write protection for RAD 
files. The hardware write-lock feature furnishes memory 
protection for all non-l/O operations. 

The hardware write-lock feature inhibits both foreground 
programs (write-lock 10) and background programs (write- 
lock 01) from storing outside their own memory area. An 
exception is the Public Library which resides in the fore- 
ground area of memory but executes under the key of the 
calling program (either background or foreground). This 
permits Public Library routines to use a Temp Stack in 
the calling routine's portion of memory. Also, some Moni- 
tor routines are given a skeleton key. One such routine is 
the Job Control Processor, which executes in the background, 
but has to set system flags in the Monitor portion (write- 
lock 1 1) of memory. 

Background programs causing protection violations are 
aborted; foreground programs are not aborted but must pro- 
cess all traps resulting from memory violation (see TRAPS 
system call). 

Memory protection on all input operations performed via 
Monitor functions (except IOEX) is guaranteed by the Mon- 
itor software. The Monitor checks the validity of the input 
area on all read operations to ensure that the area is wholly 
contained in the calling program's write-lock area. If an 



Monitor 



attempt Is made to read into an invalid area of core, an 
error condition is returned to the error address specified by 
the user. If no address is specified, the job is aborted. An 
"FG" key-in is required before a foreground program can 
be loaded from the background job stack; this protects the 
foreground from an error in a background job stack. 

RAD WRITE PROTECTION 

The Monitor furnishes software write-protection of RAD files 
above and beyond that furnished by the hardware write- 
protect switches on the RAD. Background programs are 
allowed to write only in the Background Data area or Back- 
ground Temp areas of the RAD. Foreground programs are 
allowed to write only in the Foreground Data areas. The 
foreground user is responsible for ensuring that IOEX (direct 
I/O) writes only in the IOEX Access area of the RAD. The 
Systems program area, Foreground program area, and Back- 
ground program area can be written into only if the "SY" 
key-in is in effect. 

Similarly, the Overlay Loader and RAD Editor (background 
processors) are allowed to write in nonbackground areas only 
if the "SY" key-in is in effect. Any RAD write-protection 
violation will result in a write-protection error indication 
return, and the write order will not be carried out. 

All RAD files (and all of memory) can be read by a user 
without restrictions. There is no Monitor-furnished read 
protection for memory or RAD files. 

PROCESSING PROGRAMS 

The following language translators are available for inclu- 
sion in the operating system: 

FORTRAN IV-H 

SL-1 

Symbol 

Macro-Symbol 

FORTRAN IV-H is a compiler that operates in the back- 
ground but is capable of generating code that will function 
in a real-time environment. 

SL-1 is a simulation language to solve differential equations 
as the fundamental procedure in simulating parallel, con- 
tinuous systems. An extensive set of macros permit the user 
to simulate a wide variety of linear and nonlinear elements 
through the use of single-operator statements. These proto- 
type statements are inserted into the user program each time 
a macro is referenced by name. 

Symbol is a one-pass assembler that accepts symbolic input 
and outputs programs in Sigma 5/7 standard object language. 

Macro-Symbol is a two-pass assembler with procedure capa- 
bility that accepts both symbolic and compressed format 
programs as input, and provides standard sequential editing 
for compressed input files. The assembler outputs programs 
in Sigma 5/7 standard object language. 



SERVICE PROGRAMS 

Service Programs provide routines for performing frequently 
used functions. The service programs include the Overlay 
Loader and the RAD Editor. 

OVERLAY LOADER 

The Overlay Loader (a background processor) can be used 
to create overlay programs for later execution in either the 
foreground or background. Thus, if a foreground program 
can tolerate a slight delay in reading the overlays into 
core for execution, either foreground or background pro- 
grams of virtually unlimited size can be constructed even 
though core size is restricted. For example, a 1400-word 
overlay can be input in about 50 milliseconds, assuming a 
Model 7204 RAD is available. That is, the time required 
to bring in an overlay for execution is the time of the one 
RAD access required to read the overlay. Since a program 
is stored on the RAD in core image format, it can be loaded 
very quickly as one logical record per segment. A program 
loaded by the Overlay Loader can be entered permanently 
into the System Programs Directory, Foreground Programs 
Directory, or Background Programs Directory, or it can be 
loaded on a temporary file in the Background Temp area of 
the RAD. 

The overlay structure as illustrated in Figure 1 is restricted 
to a permanently resident root section and any number of 
overlay segments. A blank COMMON and labeled COM- 
MON data area can be established for use by the root and 
overlay segements. Each segment is created by the Loader 
from one or more object modules output by the Symbol, 
Macro-Symbol, or FORTRAN IV-H processors. The Loader 
will build the Program Control Block, the OVLOAD table 
(used to load the overlay segments at execution time), al- 
locate or build DCBs, and allocate the temp stack. It will 
also load library modules to satisfy unsatisfied references 
encountered in the loading process. A maximum of two 
libraries can be searched. Library search and loading are 
extremely fast, due to special tables that are added to the 
library files at the time the library is created on the RAD. 

The overlay segments must be explicitly defined at load 
time and explicitly called atexecution time. There is no 
provision for implicitly calling in an overlay segment. All 
segments in a path may communicate with each other via 
REF/DEF linkages, but it is the user's responsibility to en- 
sure that any segment referenced is currently in core. 

RAD EDITOR 

The RAD Editor (a background processor) controls RAD allo- 
cation for areas containing permanent RAD files and per- 
forms utility functions for all areas. The RAD areas with 
permanent files include Background Programs, Foreground 
Programs, System Programs, and data areas. 

The RAD Editor performs the following functions: 

1. Adds or deletes entries to the permanent file directories. 

2. Compacts the RAD areas by relocating RAD files and 
updating/compacting directories to regain space within 
an area. 

3. Maps permanent RAD file allocation. 
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Figure 1. Overlay Structure 



4. Builds and maintains library files on the RAD for use 
by the Overlay Loader. 

5. Copies permanent RAD files from one file to another. 

6. Saves the contentsof RAD areas in self-reloadable form. 

7. Restores RAD areas previously saved. 

8. Dumps the contents of permanent RAD files or areas. 

JOB ORGANIZATION 

The user controls the construction and execution of a back- 
ground job by means of control cards placed before, within, 
and following the input card decks. These control cards, 
interpreted by the Job Control Processor, Overlay Loader, 
or RAD Editor, specify 

Processors required and the options to be used. 

Input/output devices required and their specific 
assignments. 

Loading and execution requirements. 

Libraries and supporting services required. 

Program modification and debugging (postmortem dump) 
requirements. 

A batch job is the basic independent task performed by the 
operating system. Each such background job is independent 
of any other job and consists of one or more directly or in- 
directly related job steps. A job results in the execution of 
a processing program such as a language translator, service 
program, or user's program. 

A foreground task may cause the background process to be 
checkpointed if additional core storage area is required for 
the real-time program. The Monitor's checkpoint routine 
saves all data needed to restart a checkpointed job along 
with the job. 



HARDWARE CONFIGURATIONS 

The minimum configuration required and supported by RBM 
for either a Sigma 5 or Sigma 7 is the following: 

Sigma 5 or Sigma 7 CPU with two clocks and 
Integral IOP 



Memory Protect Feature 
Memory Module: 4096 words 
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Memory Increment: 4096 words each for a total of 
12,228 words" 

Keyboard/Printer with Paper Tape Reader/V'unch 

RAD Control and .75MB RAD Storage Unit 

Interrupt Control Chassis 

Priority Interrupt, Two Levels 

External Interface Feature 

Note that an external interrupt level is required at execu- 
tion time for each real-time task in the system, and another 
external interrupt level is required for the RBM Control Task. 



To run background only, these items are not required in 
the minimum configuration. To run background/foreground, 
the complete list is required. 

Memory Module and Memory Increment comprise a 
total of 16K. 
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In addition to the previous list, any items from the list 
below can be added for increased performance and will be 
specifically supported by RBM. Other items can be added 
to this list but will not receive any special RBM support. 

Floating-Point Arithmetic 

Memory Module 

Memory Increment 

Multiplexor IOP with Eight Channels 

Additional Eight Multiplexor Channels 

Selector IOP 

Decimal Arithmetic 

Keyboard/Winter 

Paper Tape Reader/Punch (High-Speed) 

Card Readers 

Card Punches 

RADs 

9-Track Magnetic Tape 

7-Track Magnetic Tape 

BCD and Binary Packing Options for 7-Track Magnetic 
Tape 

Buffered Line Printers 

Plotters 

SYSTEM CONFIGURATIONS 

CORE SPACE CONSIDERATIONS FOR A 
MINIMUM SYSTEM 

The minimum size of a resident RBM is 5-1/2K words. This 
will support foreground/background processing under the 
minimum hardware configuration, but not floating-point 
or decimal arithmetic simulation software, or jobaccounting. 
The floating-point simulation software requires about 500 
words; decimal arithmetic requires about 800 words; and 
job accounting requires about 100 words. 



RBM will support the following system processors in a maxi- 
mum background space of 11K (some of which require con- 
siderably less than 11K): 

Macro -Symbol 

Symbol 

FORTRAN IV-H 

SL-1 

Overlay Loader 

RAD Editor 

WIRING OF EXTERNAL INTERRUPTS 

External interrupts must be wired so that their priority and 
address both have a corresponding monotonical ly increasing 
or decreasing sequence. That is, the highest priority inter- 
rupt must be connected to the lowest address interrupt cell; 
the next highest priority interrupt must be connected to an 
address greater than the highest priority interrupt, etc. 

A user can wire external interrupts to give them a higher 
priority than the I/O interrupt within the following 
restrictions: 

1. A task connected to the high-priority interrupts cannot 
use any Monitor function that performs I/O (e.g., 
READ, WRITE, IOEX). 

2. Such a task cannot perform its own I/O if the I/O de- 
vice is connected to the central I/O interrupt level. 

In general, a foreground task should not be connected to an 
interrupt whose priority is higher than the I/O interrupt 
except in a situation where instant response must be guaran- 
teed. In this special case, a task that must perform I/O 
could do direct data I/O or trigger a lower priority task to 
perform system I/O. 
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2. CONTROL COMMANDS 



The Monitor is controlled and directed by means of control 
commands. These commands effect the construction and exe- 
cution of programs and provide communication between a 
program and its environment. The environment includes the 
Monitor and the Macro-Symbol, Symbol, FORTRAN IV-H 
SL-1, Overlay Loader, and RAD Editor processors, theoper- 
ator, and the peripheral equipment. 

Control commands have the general form 



r 



! mnemonic specification 



vhere 
I 



is the first character of the record and identifies 
the beginning of a control message. 



mnemonic is the mnemonic code name of a control 

function or the name of a processor. The name may 
begin any number of spaces after the ! character, 
except for an EOD command. 

specification is a listing of required or optional 

specifications. This may include keywords, labels, 
and numeric values appropriate to the specific 
command. 



In this manual, the options that may be included in the 
specification field of a given type of control command are 
shown enclosed In brackets (no brackets are actually used 
in control commands, and parentheses are required to indi- 
cate the grouping of subfields). 

One or more blanks mmf separate the mnemonic and specifi- 
cation fields, but no blanks can be embedded within a field. 
A control command is terminated by the first blank after the 
specification field, or, if the specification field is absent 
and a comment follows the command, the command is termi- 
nated by a period after the blank that follows the mnemonic 
field. Annotational comments detailing the specific pur- 
pose of a command may be written following the command 
terminator, but no control command record can contain more 
than 80 characters. 

A control command can be continued from one record to the 
next by using a semicolon to replace the comma as a sub- 
field terminator in the specification field of the command. 
Column one of the continuation card must contain either an 
exclamation mark (if the control command is read by the Job 
Control Processor), or a colon (if the command is read by 
the Overlay Loader or RAD Editor). See the control com- 
mand examples given later in this chapter for an illustration 
of the proper use of the semicolon. 

Communication between the operator and the Monitor is ac- 
complished via control commands, key-ins, and messages. 



Control commands are usually input to the Monitor via 
punched cards; however, any input device(s) may be desig- 
nated for this function. All control commands are listed on 
the output device designated as the listing log (normally a 
line printer). In this manner, the Monitor keeps the oper- 
ator informed regarding the progress of the job. When a job 
is aborted, all control commands skipped over until the next 
JOB command is encountered are listed on LL with a greater 
than character (>) in column one. 

Note that in all control commands, the first three characters 
after the exclamation character are sufficient to define any 
mnemonic code or keyword. 

Control commands may be categorized as follows: 



System Control 

JOB 

ASSIGN 

LOAD 

ATTEND 

MENAGE 

PAUSE 

CC 

LIMIT 

SJDLB 

&QV 

PQQL 
ALLOBT 
MODIFY (special) 

Input Control 

EOD 
FIN 



Debug Control 

PMD 

Utility Control 

PJFJL 

P.REC 

SFIL 

REWIND 

UNLOAD 

WE.OF 

DAL 

Processor Control 

OLOAD 

RADEDIT 

MACRSYM 

SYMBOL 

FORTRANH 

SL-1 



JOB CONTROL PROCESSOR 

All control commands are read from the "C" (op label) device 
by the Job Control Processor (JCP). The JCPis aspecial pro- 
cessor loaded into the background by RBM upon the initial 
"C" key-in. The JCP is also reloaded into the background 
following each job step within a job. A job step is defined 
as all control commands required for the setup and execution 
of a single processor or user program within a job stack. 

The JCP processes each control command until a request is 
made to execute a processor or user program, at which time 
the appropriate program is read into the background and 
given control. A detailed description of the JCP interface 
with the system processors or user programs is given later in 
this chapter under "Processor Control Commands". 

SYSTEM CONTROL COMMANDS 

JOB Each background job to be processed by the system 

must begin with a JOB control command. The JOBcommand 
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signals the completion of the previous [ob, if any, and the 
beginning of a new one. The JOBcommand causes the tem- 
porary assignments of all operational labels (except the "C" 
operational label) to be reset to their permanent assignments. 

The form of the JOB command is 



JOB[account number, name! 



where 

account number identifies the account or project. 

If consists of from 1 to 8 alphanumeric characters. 

' name identifies the user. It consists of from 1 to 

12 characters. 

Note that a comma separates the optional subfields. The 
account number must precede the name,and both fields must 
be present if either one is present. 



Example: 



! JOB I2345,JOBSAMPl 



The above example defines the account number for the job 
as 12345, and the user as JOBSAMP1. 

ASSIGN The ASSIGN control command specifies the 

physical peripheral devices or RAD files to be used in pro- 
cessing the current job step, and the uses to which they will 
be put. ASSIGN commands must appear prior to the appro- 
priate RUN or Processor name command and affect only that 
one job step. Each ASSIGN command assigns a Data Con- 
trol Block (DCB) name to an operational label (logical 
device name), a RAD file, or a physical device. An opera- 
tional label is a symbolic name used to identify a logical 
system device (see Table 1). The "name" to which a DCB 
is assigned may be either a system physical device name of 
the form 

yyndd 



yy 



specifies the type of device (see Table 2). 



n specifies the channel letter (see Table 3). 

dd specifies the device number (see Table 4), in 

hexadecimal. 



or an operational label, background temp file, permanent 
RAD file, or numeric zero. 

If there is an error in an ASSIGN command, the entire 
command must be input again. 





Table 1. Monitor 


Operational Labels 


Label 


Reference 


Comments 


BI 


Binary input 


Used to input binary 
information. 


CI 


Compressed 
input 


Used by Macro-Symbol. 


SI 


Symbolic 


Used to input source 




input 


(symbolic) information. 


C 


Control com- 


Used by the Monitor and 




mand input 


processors to read control 
commands. 


BO 


Binary output 


Used to output binary 
information. 


DO 


Diagnostic 


Used by the Monitor for 




output 


postmortem dump and 
diagnostic messages. 


LO 


Listing output 


Used for object listings 
from assembl ies and 
compilation. 


CO 


Compressed 
output 


Used by Macro- Symbol. 


LL 


Listing log 


Used by the Monitor to 
log control commands and 
other system messages. 


OC 


Operator's 


Used by the Monitor for 




console 


key-ins and operator con- 
trol. (Always assigned to 
a keyboard/printer.) 


SO 


Symbolic 
output 


Used by SL-1. 


PL 


Plotter output 


Used by user programs 



Table 2. I/O Device Type Codes 



yy 


Device Type 


TY 


Typewriter 




LP 


Line printer 




CR 


Card reader 




CP 


Card punch 




9T 


9-track magnetic tape 




71 


7-track magnetic tape 




PP 


Paper tape punch 




PR 


Paper tape reader 




DC 


RAD or other disc storage 




PL 


Plotter 




NO 


Not a standard device. Used as 
purpose device for IOEX. 


a special 
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Table 3. Channel Designation Codes 



Table 5. RAD Area Mnemonics 



Specified 


Corresponding 


Channel 


Decimal Digit 


Letter (n) 


of Unit Address 


A 





B 


1 


C 


2 


D 


3 


E 


4 


F 


5 


G 


6 


H 


7 



Table 4. Device Designation Codes 


Hexadecimal 
Code (dd) 


Device 
Designation 


00 £ dd ^ 7F 
(single devices) 


Refers to a device number 
(00 through 7F). 


80 £ dd s FF 
(multiple devices) 


Refers to a device controller 
number (8 through F) fol- 
lowed by a device number 
(0 through F). 



The form of the ASSIGN control command is 

s ! ASSIGN (deb [,area, name] ) [,(option),(option), . . . , — i 

I 

1 — (option)] 



deb is the name (not exceeding eight characters in 

length) of the DCB to be assigned. It must be the 
first subfield following ASSIGN, and must be fol- 
lowed by a name specification (see below). The 
first two characters of a user's DCB name must be 



ters of a system! 



The first two cnarac- 
7&Me.g., Mi'L'O). 



area specifies the RAD area if the DCB is to be 

assigned to a RAD file, and must be one of the 
codes itemized in Table 5. 

name specifies a system physical device name, a 

system operational label, a background temp file 
name (X1-X9, GO, OV), a permanent RAD file 
name, or a numeric zero. In the "0" case, no out- 
put will be generated by the DCB. If assignment 
is to a permanent RAD file, and if "name" is 
omitted, the DCB is assigned to the entire RAD 
area. 



Cod< 


a 


Mnemonic 


SP 




Systems Program area 




FP 




Foreground Program area 




BP 




Background Program area 




BT 




Background Temp area 




XA 




IOEX area 




CK 




Checkpoint area 




Dl 








DA 


• 


Data area (number of data areas 
defined at SYSGEN) 


are 


DF . 








Note: If the DCB is assigned to a background 
temp file, the area can be omitted. 



The options below are used only if the user creates the DCB 
or changes some of the DCB's parameters. Note that DCB 
parameters not specified on the ASSIGN command are not 
changed from their initial value. The initial values of the 
DCB parameters depend upon how the DCB was created. 
Parameters of System DCBs have standard default values. 
DCBs allocated by the Overlay Loader (F:DCBs) are set to 
all zeros. User created DCBs have the initial values speci- 
fied by the user. 

Mode may be any or all of the following: 



BCD 

BIN 

VFC 
NOVFC 

PACK 

UNPACKJ 



specifies the EBCDIC or automatic 
device mode. 

specifies the binary device mode. 

specifies vertical format control, 
no vertical format control. 

specifies that the packed binary or un- 
packed binary mode is to be used 
for 7-track magnetic tape. 



number of recovery fries 

TRIES, value specifies the maximum number of re- 

covery tries to be attempted for an I/O operation. 
The value must be less than 256. 

default record length 

RECL, value specifies the default record length in 

bytes. The value n must be 1 £ n < 32,767. This 
record length is used for all requests referencing 
the DCBs that do not explicitly specify a record 
length in the FPT. 
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Examples: 

1. Assign listable output to a magnetic tape: 



/\ ASSIGN (M:LO, 9TA81),VFC 



This example assigns the M:LO DCB to a 9-track mag- 
netic tape. Vertical format control is also specified, 
so the first byte in each record is a format control byte 
for the line printer. 

2. Assign binary output to the GO file on RAD; | 
! ASSIGN (M:BO,GO) 



This example assigns the M:BO DCB to the GO file. 
Note that in this case the RAD area can be omitted. 

3. Assign source input to a RAD file in the Dl Data area: 
! ASSIGN (M:SI, Dl,PRESTORE) 



This example assigns the M:SI DCB to the RAD file 
PRESTORE, which is in the Dl area. This type of as- 
signment could be used to assemble a source program 
that had been prestored onto a RAD file. 

4. Build a user DCB that was left empty at load time: 



! ASSIGN (F:XX,7TAE0), PACK, (TRIES, 3), 



J 



-(RECL,80) 



This example builds a user DCB, F:XX, and also as- 
signs F-.XX to a 7-track magnetic tape. The packed 
binary mode (PACK) will be used in accessing the 
tape, and a maximum of three recovery tries (TRIES, 3) 
will be attempted for a possible tape parity error. The 
default record size to be read or written is 80 bytes 
(RECL, 80). 

5. Assign a user DCB to read nonstandard binary codes: 

! ASSIGN (F:INP,CRA03), BIN 



LOAD The LOAD control command directs the JCP 

Loader to load a program on the RAD and absolutize it for 
its core execution location. 

The form of the LOAD command is 
S\ LOAD [(option), (option)] 



where the options are 

IN[, area], name specifies the input device as a 

system physical device name, a system operational 
label, or a RAD file from which the object mod- 
ules will be loaded. The default input device is 
the one assigned to the BI operational label. 

OUT[, area], name specifies the output device as 

an operational label or a RAD file on which the 
loaded program is written. The default output de- 
vice is the OV file. A foreground program can 
only be loaded on the FP area of the RAD or the 
OV file. 

EXLOC, value specifies the execution location (in 

hexadecimal) of the program being loaded. The 
default location will be the start of background. 

SEG, value specifies the decimal number of overlay 

segments that follow the root. The default value 
is zero, which means only a root is being loaded. 

MAP specifies that a map of the loaded program be 

output to the LO device. The default is no map. 

JF] specifies that the program being loaded is a fore- 
IbJ ground program (F) or background program (B). The 
default is a background program. 



The primary function of the JCP Loader is to load the Over- 
lay Loader and RAD Editor at SYSGEN time. However, the 
JCP Loader will load any nonoverlaid program on the RAD 
under certain restrictions (see Appendix D). 

Example- 
Load Overlay Loader from cards: 

! LOAD (IN,CRA03),(OUT,SP,OLOAD), , 



L 



(SEG,5),MAP 



This example assigns the user DCB, F:INP, to the card 
reader, and specifies that the binary mode is to be used 
in reading the cards. This type of assignment would be 
used to change an existing DCB to read nonstandard 
binary cards. 



This command would be used to load the Overlay Loader 
onto its permanent file (OLOAD) on the SP area of the 
RAD. Five overlay segements (SEG, 5) are specified 
and a MAP of the load is requested. The complete 
deck structure required to perform the load is illustrated 
in Figure 2. 
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!FIN 



!EOD 



4. 

|Bim 




HWAWNWiydUU 



nary Deck of Overlay 6 



Binary Decks of Overlays 3-5; each deck 
followed by an ! EOD 



<> 



!EOD 



M 



~\ 



^2 



Binary Deck of Overlay 2 



% 



I EOD 



Binary Deck of Overlay 1 



!EOD 



Binary Deck of Overlay Loade 
1 1 (QUT,SP,OLOAD),(SEG,6),MAP 




!LOAD(IN,CRA03); 



! Pause Key-in 'SYC 



!JOB 



Figure 2. Loading Overlay Loader from Cards 

ATTEND The ATTEND control command is used during an 
attended run and indicates that RBM is to go into a WAIT 
condition after a WAIT system call, or after an abort from 
the background. After an unsolicited key-in of "C", back- 
ground processing will continue from the point of the wait. 
If the ATTEND control command is not specified, and an 
abort or error condition occurs, or if a WAIT system call is 
made, the Monitor does not pause for operator intervention 
but skips all control commands, binary records, and data 
until a JOB or FIN command is encountered. When in skip- 
ping mode, all control commands encountered will be listed 
on the LL device, with a greater than character (>) replac- 
ing the exclamation mark in column one. Hence, the de- 
fault mode of operation (no ATTEND command) is for closed- 
shop batch processing, with no halts between jobs after 
an abort. 

The form of the ATTEND command is 



r 



! ATTEND 



The effect of an ATTEND command exists for one job only. 
Normally, the ATTEND command immediately follows the 
JOB command. 



MESSAGE The MESSAGE control command is used to 

type a message to the operator. The message will be typed 
on the OC device, and normal processing will continue 
after the message is output. 

The form of the MESSAGE command is 

! MESSAGE message 



where message is any comment to the operator, up to a full 
card image (80 columns). The message may contain any de- 
sired characters, including blanks, but may not be con- 
tinued from one record to the next. Two or more MESSAGE 
control commands may be used in immediate succession. 

Note that the entire card image, including the ! MESSAGE, 
will be output to LL and OC. 



Example: 

A 



! MESSAGE SEND ALL SAVE TAPES TO JOHN SMITH 



The above example would cause the following message to be 
output on the LL and OC devices: 

! [MESSAGE SEND ALL SAVE TAPES TO JOHN SMITH 

Note: All Monitor messages to the operator begin with two 
exclamation characters. 

PAUSE The PAUSE control command is similar to the 

MESSAGE command except that the JCP will enter a WAIT 
state after the message is output to OC to give the operator 
time to carry out the instructions in the message. Process- 
ing is continued after an unsolicited key-in of "C". 

The form of the PAUSE command is 

f\ PAUSE message 



where message is any comment to the operator, up to a full 
card image (80 columns). 

Example: 

! PAUSE KEYIN SYC 



The above example would cause the Monitor to pause exe- 
cution with the following message output on LL and OC, 

! ! PAUSE KEYIN SYC 

giving the operator time to key in SYC, which would permit 
the user to override the write protection on the RAD and 
continue the background job. 
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CC The CC control command removes typewriter over- 
ride of the C device (see TY key-in description). The next 
control command will be read from the C device instead of 
the typewriter. 

The form of the CC control command is 

! CC 



The CC control command has the same effect as the CC key- 
in, and can be used whenever the JCP has control. 

LIMIT The LIMIT control command is used to set a maxi- 

mum allowable execution time for a background program. 
If the job exceeds the time limit, the background is aborted 
with a postmortem dump (if the dump option was specified 
via a PMD control command). 



The form of the LIMIT control command is 



LIMIT n 



where n specifies the maximum allowable execution time 
in minutes. 

STDLB The STDLB command is used to change the tempo- 
rary assignment of an operational label, with the exception 
of OC (operator's console). The operational labels being 
.changed receive the new temporary assignments which stay 
in effect until the next JOB command is encountered. 

The form of the STDLB command is 

! STDLB (label[,area],name)[,(label[,area],name). . .] 



vhere 



label specifies one of the standard operational 

labels input during SYSGEN (see Table 2). 

area specifies a RAD area for an operational label 
assignment to a RAD file. If an operational label 
is assigned to a file in the Background Temp area 
(XI -X9, GO, OV), only the file name need be 
specified. 

name specifies a physical device name to which the 
operational label is to be temporarily assigned, a 
RAD file name, a numeric zero, or another oper- 
ational label. In the latter case, the first oper- 
ational label will receive the same assignment as 
the temporary assignment of the second operational 
label. If "0" is specified, there is to be no tempo- 
rary assignment, which means that no output will 
occur on that label. The C op label cannot be as- 
signed to zero via this command. Note that if an 
error occurs on a ISTDLB command, all fields up 
to the one in error will be processed. 



Example: 

Change temporary assignments of operational labels: 

/\ STDLB (BO,GO),(CO,D2,COMPRESS),(LO,9TA80) 



This example could be used for Macro-Symbol assembly to 
change the binary output to the GO file in the RAD, the 
compressed output to the COMPRESS file in the D2 area of 
the RAD, and the listable output to a 9-track magnetic tape. 

ROV The ROV command (RUN OV) causes execution of 

the program (either foreground or background) on the OV file. 

The form of the ROV command is 



/\ ROV 



The loading of any program into the foreground area via a 
ROV control command must be preceded by an FG key-in 
(see Chapter 3). A foreground program loaded by !ROV is 
given the name OV. There may be only one such program 
resident at any time. 

RUN The RUN control command causes the named pro- 

gram (either foreground or background) to be executed. 

The form of the RUN command is 
! RUN area, file name 



area,file name specifies a RAD area and the file 

name of the program in that area that is to be exe- 
cuted. The area must be either SP, FP, orBP. The 
loading of any program into the foreground area 
via a RUN control command must be proceded by 
an FG key-in. 

POOL The POOL control command is used to override 

the default allocation of blocking buffers for the background 
by the JCP. The POOL command takes effect only for a job 
step and not for the duration of an entire job. 

The form of the POOL command is 
/ . \ POOL n 



specifies the number of 256-word blocking buffers 
that are to be allocated to the background for the 
blocking and deblocking of blocked or compressed 
RAD files. The n value must be less than 255, and 
the value of 256n + n + 1 cannot exceed the avail- 
able background space. 
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ALLOBT The ALLOBT control command is used to define 

the files in the BT area of the RAD, and overrides any JCP 
default definitions. The files input on the ALLOBT command 
will receive the specified sizes and formats. The files de- 
fined via an ALLOBT command will stay in effect only for 
the current job step unless the SAVE option is invoked. If 
the SAVE option is used, the ALLOBT command will stay in 
effect for the entire job (any input for the GO or OV files 
will always stay in effect for the entire job). 

The form of the ALLOBT command is 
/\ ALLOBT (FILE,nn)[,(option),(option). . .] 



FILE,nn specifies the name of the background temp 

file to be allocated. Legal names for nn are 
XI, X2, ...,X9,GO, orOV. 

and the options are 

FORMAT, value specifies the format of the file; 

U for unblocked, B for blocked, C for compressed. 
The default is unblocked for all files except GO; 
the default for GO is blocked. 

FSIZE, value specifies the decimal length of the file 
in logical records. If ALL is input for a value, the 
remainder of the BT area will be allocated for this 
file. An ALL input is allowed only once, and is 
only allowed for Xi files (not GO or OV). A check 
is made for overflow of the BT area at the time the 
ALLOBT command is input. The default value is 
1000 records. Note that the file size in sectors 
is computed using the logical record size and not 
the granule size. 

RSIZE, value specifies the decimal number of words 

per logical record. This field is only meaningful 
for blocked or unblocked files, since the Monitor 
compresses records of compressed files into 256- 
word blocks. Blocked files have a default record 
size of 128 words, and unblocked files have a de- 
fault record size equal to the granule size. Note 
that if RSIZE > 128, unblocked organization will 
always be given to the file. 



Example: 

Change the default assignments of the background temp 
files: 



The group of ALLOBT commands 

!ALLOBT(FIL,OV),(FSIZ,0) 



!ALLOB(FIL,X4),(FSI,ALL) 



!(GSIZE,180) 



!ALLO(FILE,X3),(FSIZE,20); 



2. 



1 



! (FSIZE, 100), (RSIZE ,30) 



! ALL(FILE,X2) ,(FORMAT,B) ; 



—|! (FSIZE, 1000),SAVE 



1. !ALLOBT(FILE,Xl),(FORMAT,C); \ 



could be used by a background program to achieve the fol- 
lowing results: 

1. The XI temp file would be a compressed file that could 
hold approximately 1000 EBCDIC cards. This file would 
be saved throughout the entire job. 

2. The X2 temp file would be a blocked file which could 
hold a maximum of 100 binary cards. 

3. The X3 temp file would be an unblocked file contain- 
ing 40 sectors (assuming a 7204 RAD) with a granule 
size of 180 words or two sectors. 

4. The X4 temp file would be an unblocked file with a 
record and granule size of 90 words (assuming a 7204 
RAD) and would be allocated the remainder of the 
Background temp area. 

5. The OV file would not be allocated. 

After inputting this series of ALLOBT commands, the back- 
ground temp area would have the following layout (assuming 
a 7204 RAD): 



GSIZE, value specifies the decimal number of words 
per granule. This field is only used in directly 
accessing a file. The default granule size will be 
the size of a RAD sector. 



SAVE specifies that this file is to be saved through- 
out the job and not reallocated between job steps. 



X2 



X3 



X4 



XI 



GO 



36 Sectors 40 Sectors n Sectors 120 Sectors Default Size | 

Note that X4 receives n sectors, where n is the remainder 
of the area after all other files have been allocated. XI is 
allocated at the opposite end of the BT area, since it will 
be saved throughout the entire job. 
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The formula used to calculate the number of RAD sectors for 
X2 is the following: 



RSIZE 
256 



x FSIZE x 3 



where 256 is the number of words per blocking buffer and 
3 is the number of RAD sectors (assuming a 7204 RAD) 
necessary to contain a blocking buffer. 

The formula used to calculate the number of RAD sectors 
for XI is 



FSIZE 
25 



x 3 



where it is assumed that 25 cards can be compressed into a 
256-word blocking buffer. The number 3 is the number of 
RAD sectors necessary to contain a blocking buffer. 

MODIFY The Monitor MODIFY control command is a 

special command used only at system boot time to modify 
(patch) one or more system modules. Its use must be pre- 
ceded by sense switch settings 1 through 3. (See Appen- 
dix E "System Patching" for a complete description of con- 
trol command format and use.) 

DEBUG CONTROL COMMANDS 

PMD The postmortem dump (PMD) control command 

causes the Monitor to dump a specified area of memory if 
a background [ob is aborted during execution. Such a dump 
is termed "postmortem" because it is performed after the 
background program has been aborted, terminated normally, 
or not executed at all for any reason. The dump is always 
output on the DO device. In the case of an abort the time 
to perform the dump is not included in the total time on the 
LIMIT control card. Note that the PMD command must pre- 
cede the RUN command. 

The form of the PMD command is 

! PMD [U][,(from,to)][,(from,to)]... 



U specifies that an unconditional dump at the end 

of the job is to be output, even if there were no 
errors. If U is absent, the dump occurs only if 
the job is aborted. 

from specifies the location (in hexadecimal) at 

which dumping is to begin. If no locations are 
specified, the entire background is dumped. 

to specifies the last location (in hexadecimal) to be 
dumped. The last location must 2 first location. 

A maximum of four location pairs is processed and only the 
last PMD command is honored within a job step. If an error 
occurs anywhere on the command, the entire command must 
be reinput. 



Example: 

Request a postmortem dump: 



! PMD U,( 1200,1 300),(2000,3000) 



This example requests an unconditional dump at the termina- 
tion of the next program to run in the background. Loca- 
tions 1200 16 through 1300i o , and 2000 16 through 3000 16 
will be output on the DO device. 
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Note that EOD control commands must not have any spaces 
between the exclamation character and the mnemonic. 

EOD The user may define blocks in a data deck by in- 

serting EOD control commands at the end of each block. 
When an EOD command is encountered, the Monitor returns 
an EOD status. Any number of EOD commands may be used 
in a job and for any reason. 

The form of the EOD command is 

/lEOD 



FIN The FIN control command is used to specify the end 

of a stack of jobs. When the FIN command is encountered, 
the Monitor writes it on the listing log to inform the opera- 
tor that all current jobs have been completed, types "BEGIN 
IDLE" on OC, and then enters the idle state. All time pre- 
ceding the FIN command is charged to the previous job, if 
job accounting is being performed. All time from the FIN 
command to the next JOB command is charged to the idle 
account. 

The form of the FIN command is 



A7i 



N 



UTILITY CONTROL COMMANDS 

The utility control commands described below allow the 
user to manipulate RAD files or magnetic tape files. 

PFIL, PREC The file and record positioning commands are 
used to position a device within its current file. The PFIL 
command, which is only valid for magnetic tapes or RAD 
files, will leave the device positioned before the file mark 
in the appropriate direction. Only background devices 
(not dedicated to the foreground or IOEX)can be positioned. 
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The forms for the PFI L and PREC control commands are 



rflPREcl [° re °,] name [' BACK J(>] 



[area,] name specifies a system device name, 

operational label, or RAD area and file name of 
the device that is to be positioned. This must be 
the first item in the specification field. 

BACK specifies that the direction of the position- 
ing is backward. The default is forward. 



n 



specifies the number of records to skip. The "n" 
parameter applies only to the PREC command and 
not to PFIL. The default is skip one record. The 
PF1L command always refers to one file. 



Examples: 

1. Position a RAD file to the end of the data: 



PFIL GO 



This example could be used to position the GO file so 
additional object modules could be added to those al- 
ready existing. 

2. Position a RAD file: 

! PREC D1,ABCD,30 



BACK specifies that the direction of the positioning 
is backward. The default is forward. 

n specifies the number of files to skip. The default 

is one file. 



Example: 

Skip tape files: 

/l SFIL 9TA82,BACK,4 



This example would cause back skipping of four files on the 
designated 9-track magnetic tape. 

REWIND The REWIND command is used to rewind a mag- 

netic tape or a RAD file. It has no effect on other devices. 

The form of the REWIND command is 



r 



REWIND [area,] name 



where 

[area,] name specifies a system device name, op- 

erational label, or RAD area and file name of the 
device that is to be rewound. 

Example: 

Rewinding a tape 

! REWIND 7TAE0 



This example would position RAD file ABCD 30 records 
forward from its current position. 

SFIL The skip file command is used to skip one or 

more files on a magne tir tripe nnU hut- cannot be used to 
position a RAD fjj fi^ When skipping forward, the SFIL 
command leaves the device positioned following the speci- 
fied EOF. When skipping backward, the device is posi- 
tioned at the first record of the designated file. 

The form of the SFIL control command is 

/\ SFILname[,BACK][,n] 



where 



name specifies a system device name or operational 
label of the device that is to be positioned. This 
must be the first item in the specification field. 



This example would rewind the designated 7-track tape. 

UNLOAD The rewind manual (UNLOAD) command 

causes the specified magnetic tape to be rewound in manual 
mode. Operator intervention will be required to use the 
device again (i.e., depressing the ATTENTION and START 
switches on a tape drive). An UNLOAD command for a 
RAD file produces the same results as a REWIND command. 

The form of the UNLOAD command is 

X\ UN LOAD [area,] name 



[area,] name specifies a system device name, oper- 
ational label, or RAD area and file name of the 
device that is to be rewound in manual mode. 
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Example: 

Unload a magnetic tape: 

/\ UNLOAD 9TA83 



This example would cause the designated 9-track tape to be 
rewound in manual mode, 

WEOF The write end-of-file (WEOF) command causes an 

end-of-file mark to be written on the output device if an 
EOF is appropriate for the device. Fnr mnr|ne|-ji- t"pp a 
tq jge mark is written; for n ft AD filp a lo gical file mark i s 
written , for paper tape , an EOD is written. The WEOF 
command is ignored for all other devices. 

The form of the WEOF command is 



The form of the DAL command is 



! WEOF [area,] name[,nl 



whe 



[area,] name specifies a system device name, oper- 

ational label, or RAD area and file name of the 
device that is to receive the EOF. 

n specifies the number of end-of-files to write. 

The default is one. 

Examples: 

1 . Write end-of-file on magnetic tape: 



r 



! WEOF 9TA81,2 



This example would write two EOFs on the designated 
9-track magnetic tape. 

2. Write end-of-file on RAD: 

( ! WEOF GO 



This example would write a logical EOF on the GO 
file at its current position. This would result in trunca- 
tion of a file if the file was positioned at some point 
other than its end. 

DAL The Dump Accounting Log command causes the 

contents of the Accounting Log to be printed on the LO 
device. The Accounting Log is kept on the AL file on the 
Dl area of the RAD. An option exists to purge the file after 
the dump is completed. 



f 



! DAL [PAL] 



vhere 



[PAL] specifies that the Accounting Log is to be 

purged after the dump is completed. 

PROCESSOR CONTROL COMMANDS 



A processor control command indicates to the Monitor that 
control Is to be transferred to the specified processor. It 
may also specify the types of input to be accepted and the 
types of output to be produced by the processor. 

Processors can be created, updated, and deleted under nor- 
mal batch operations, and there are no restrictions as to 
how many and what kind of processors may be added to the 
system. 

User programs on the FP or BP areas of the RAD are called by 



r 



RUN area, file name 



where file name is the name of the program to be executed. 

All system processors and user processors on the System Pro- 
grams area of the RAD can be called for execution by the 
control command: 



r 



whe 



I name parameters 



name is the RAD file name of the processor to be 

executed (e.g., FORTRANH, SYMBOL, SL-1, or 
MACRSYM). Note that the RAD file name for 
Macro-Symbol should be "MACRSYM" since the 
JCP does special allocation of the BT area if the 
name MACRSYM is encountered. 

parameters are optional parameters interpreted by 

each processor. Normally, at least one input 
option and one output option must be specified. 
The options for all system processors recognized by 
RBM are defined in Table 6. 



Example: 



r 



! MACRSYM SI,LO,CI,BO 



This example specifies that control is to be given to the 
Macro-Symbol assembler. It also specifies that symbolic 
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Table 6. Processor Specification Options 



PROCESSOR INTERFACE WITH RBM 



Specification 


Use 


Used by 


BA 


Selects batch 
assembly mode. 


Macro- Symbol 


BO 


Relocatable bi- 
nary output on the 
BO device. 


FORTRAN IV- H, 
SL-1, Symbol, 
Macro- Symbol 


CI 


Compressed in- 
put from the 
CI device. 


Macro-Symbol 


CN 


Concordance 
listing. 


Symbol 


CO 


Compressed out- 
put on the CO 
device. 


Macro- Symbol 


D 


Debug mode 
compilation. 


FORTRAN IV-H 


GO 


Relocatable bi- 
nary output to 
temporary RAD 
storage (i. e. , 
the GO file). 


Symbol, Macro- 
Symbol, SL-1, 


LO 


Listing output 
produced on the 
LO device. 


FORTRAN IV-H, 
Symbol, Macro- 
Symbol, SL-1 


LS 


Source listing 
produced on the 
LO device 


FORTRAN IV-H, 
SL-1 


LU 


Listing of the 
update decks (if 
any) produced on 
the LO device. 


Macro- Symbol 


S 


S in column 1 


FORTRAN IV-H, 
SL-1 


SI 


Symbolic input 
from the SI 
device. 


Macro-Symbol, 
FORTRAN IV-H, 
SL-1 


SO 


Symbolic 
(source) output 
produced on the 
SO device. 


SL-1 



input is to be taken from the device to which the SI opera- 
tional label is assigned; listing output is to be transmitted to 
the device to which the LO operational label is assigned; 
compressed input is to be received from the device to which 
the CI operational label is assigned; and binary output is to 
be transmitted to the device to which the BO operational 
label is assigned. 

Upon reading this control command, the JCP will set up the 
blocking buffers and RAD Background Temp files for the pro- 
cessor, load the processor's root, and transfer control to the 
entry address of the root. 



The system processors under RBM are 

Macro-Symbol 

Overlay Loader 

RAD Editor 

FORTRAN IV-H 

Symbol 

SL-1 

System processors and any user processors on the System 
Programs area of the RAD should follow these common 
ground rules. 



1, 



All processors must reside on the System Programs area 
of the RAD to be callable by an ! Name command. A 
user wishing to test a new version of a processor with- 
out destroying the permanent version could execute the 
processor from the OV file via an ! ROV command. 

AM processors must operate in the background space. 

All system DCBs (M=DCBs) should be identified as a 
primary reference in the processor, since at load time, 
the Overlay Loader will furnish the processor with a 
copy of the system DCBs. 

All processors with overlay segments need only make 
the explicit call to SEGLOAD to load the segments. 
The DCB used to load segment M:SL will be furnished 
by the Overlay Loader. 

RBM will furnish the start address and end address of 
unused background memory to any processor that needs 
this information. The two addresses will be in the fol- 
lowing locations, and should be defined via the EQU 
directive in the processor: 

Location Mnemonic Description 



X'153 1 



K:BPEND 



X'141 



K:BCKEND 



LWA + 1 of the background 
program's loaded area; that 
is, this cell contains the 
FWA™ the processor can use 
for a dynamic table area. 

LWA of usable background 
memory for the processor; 
that is, this cell contains 
the LWA the processor can 
use for a dynamic table area. 



All these addresses are in bits 15-31 with bits 0-14 con- 
taining zeros. 

LWA and FWA are the last word address and first word 
address. 
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If a processor has parameters to process from the 
"! Name" control command (where "name" is the pro- 
cessor's name) the address of the buffer containing the 
control command is in cell X ' 1 44 ' . That is, 

Location Mnemonic Description 

X'144 ,t K:CCBUF Address of control card 
buffer. 

A processor must perform its own ve rJi.gflLfatgir 1, r Qfl- 
t rol of the printer if format control is required , That 
is, the processor must set the VFC (vertical format con- 
trol) bit in the DCB via the Monitor Device Format 
Control call and ensure that the first byte output to 
the printer is a format control byte. If a processor 
(i.e. , Macro-Symbol) outputs a title at the top of 
each page, the number of lines to print per page is 
contained in the following system call: 

Location Mnemonic Description 



X'174' 
byte 



K-.PAGE 



Number of lines per page to 
print. 



If a processor uses scratch files (Background Temp files 
XI -X9) and desires a different record size, granule 
size, or organization than is given by default by the 
JCP, the processor must make the appropriate system 
call on the Device Mode function. By calling the 
Device Mode function, the processor can set the file 
organization (blocked or compressed) and the appropri- 
ate record size and granule size. The Background 
Temp file default assignments by the JCP are described 
below. 



All these addresses are in bits 15-31 with bits 0-14 con- 
taining zeros. 



9. In general, the pr ocessor shou ld terminate input from 

SI when an end-of-fi I e status is sensed on SI. To termi-| 
nate, the processor should make g_system call on EXIT. 
EXIT will close all the processor's DCBs and close all 
open RAD files. 

10. A ll processors using the GO fi|e shoy[d_open GO and 
th en do a file skip (PFIL funct ion call) on_GO so the | 
GO fi le is properly position ed to receive additional 
data. The Job Control Processor will purge the GO 

file upon reading a JOB control command. 

The Job Control Processor will automatically allocate one 
blocking buffer for each system DCB (M:xx) assigned to a 
blocked file. Additionally, the JCP will always allocate 
a blocking buffer if the GO file is used, and allocates 
a maximum of two blocking buffers for all Xi (1 s 1 < 9) 
files used. If a system or user process or is not satisfied 
with the blocking buffer allocation, a POOL control com- 
mand can be used to override the default allocation. 

The JCP will also allocate the Background Temp area of 
the RAD for all Xi files, where 1 < i < 9. The GO and 
OV files will receive their SYSGEN defined sizes, un- 
less overridden with an ALLOBT command. The GO 
file will be defined as a blocked file with a logical 
record size of 120 bytes; the OV file will be unblocked 
with the record and granule sizes equal to the RAD sec- 
tor size. The JCP will scan all system DCBs and de- 
termine which of the Xi files are used. The Background 
Temp area that remains after GO and OV have been allo- 
cated will then be equally distributed among these Xi 
files. All Xi files will be given unblocked organization 
with the record and granule sizes equal to the RAD sector 
size. The user can override any of these defaults via an 
ALLOBT command. If the user desires not to have the 
Xi files reallocated between processors, the SAVE option 
on the ALLOBT command can be used. 



Processor Interface with RBM 



19 



3. OPERATOR COMMUNICATION 



When events take place in the system requiring operator 
intervention, or when one job completes and another job 
begins, RBM Informs the operator of these conditions by 
messages output to the operator's console (OC device). 
All such messages from the Monitor begin with two ex- 
clamation marks (!!). Generally, these messages require 



no operator response on the typewriter, but may indicate 
that some peripheral needs attention. 

RBM MESSAGES 

The messages itemized in Table 7 are output by the Monitor 
on the OC device. 



Table 7. Monitor Messages 



Message 



Mi 



,eaning 



HBACKG CKPT 

!!BCKG RESTART 
IIBACKGUSED BY FGD 

! I BEGIN WAIT 

UCK AREA TOO SMALL 



! ICKPT WAITING FOR BCKG I/O 
RUNDOWN 

! SCORE USED, CAN'T LOAD xxxxxxxx 



!!FGD AREA ACTIVE 

! !FGT FULL, CAN'T LOAD xxxxxxxx 

I! FILE NAME ERR 

! II/O ERR, CAN'T LOAD xxxxxxxx 

! ! I/O ERR ON CKPT 

! ! JOB ABORTED AT yyyyy 

!!KEY ERROR 

! ! LOADED PROG xxxxxxxx 

HNONEXIST., CAN'T LOAD xxxxxxxx 



Background has been checkpointed as a result of a foreground program 
load. 

Background has been restarted from its point of interruption. 

Background space is being used by the foreground but a checkpoint was 
not required, since the background was inactive at the time of the fore- 
ground load. 

Background has executed a "WAIT" request. An unsolicited key-in of 
"C" will continue background processing. 

An attempt was made to checkpoint the background, but not enough space 
was available on the CK area of the RAD. The background space will 
nevertheless be released to the foreground and the active background job 
will be aborted when the background is restarted. 

The checkpoint function is waiting for all background I/O to run down so 
that the checkpoint of background can be completed. 

The specified foreground program cannot be loaded for execution because 
the core space required for its execution is already in use. 

An FMEM key-in request cannot be honored because a foreground program 
is still active in the area being released. 

The specified foreground program cannot be loaded for execution because 
no room exists in the Foreground Programs Table. 

A problem has occurred from a STDLB key-in request in attempting to 
open or close a RAD file. 

An I/O error occurred in attempting to load the specified foreground pro- 
gram for execution. 

An attempt was made to checkpoint the background, but a RAD I/O error 
occurred during the process. The background space will nevertheless be 
released to the foreground, and the active background job will be aborted 
when the background is restarted. 

Background job has been aborted. The "y/yy/" parameter contains the 
address of the last instruction executed in the background. If aborted be- 
cause the specified limit on a ! LIMIT control command has been reached, 
the yyyyy parameter will contain the word "LIMIT". 

Monitor cannot recognize an unsolicited key-in response. A new key-in 
should be attempted. 

The specified foreground programs have been loaded for execution by the 
foreground loader. A maximum of three program names will be output in 
the one message. 

The specified foreground program cannot be loaded for execution because 
it does not exist on the RAD, or a Public Library required by the program 
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Table 7. Monitor Messages (cont.) 



Message 



Meaning 



!!NOT ENUF BCKG SPACE 
!! PAUSE comments 

! IPROG xxxxxxxx RELEASED 

! "PUB LIB, CAN'T LOAD xxxxxxxx 

URLS NAME NA 

! SSIGMA 5/7 RBM-2, VERSION xxxx 

!! UNABLE TO CLOSE DCB xxxxxxxx 
UUNABLE TO DO ASSIGN 

!! UNABLE TO LOAD BCKG PUB LIB 



UUNABLE TO TRIGGER CONTROL 
TASK INT. 



Hyyndd ERROR 

!!yyndd MANUAL 
Hyyndd UNRECOG 
Hyyndd WRT PROT 



does not exist on RAD. The foreground program must exist in the FP area 
or the OV file. 

Insufficient background space to load the requested background program. 

A ! PAUSE control command card has been read. The comments field may 
contain tape mounting instructions. A key-in of "C" after pressing the 
INTERRUPT switch will cause RBM to continue reading from the job stack. 

The specified foreground program has been released. 

The request to load the specified Public Library for execution is not valid, 
since all Public Libraries must be automatically loaded by the system, as 
needed. 

A key-in request has been made to release a foreground program but the 
name of the program is not recognized by the system. 

This message is output on the OC device every time the system is booted 
from the RAD. The message can be terminated prematurely by hitting the 
BREAK key on the typewriter. 

The specified DCB was not closed upon releasing a foreground program. 

An [ASSIGN command cannot be fulfilled because either the DCB cannot 
be found, or the DCB is only five words in length, and a seven-word DCB 
is required (seven-word DCBs are required for any RAD file assign). 

The current attempt to execute a background program has failed because 
the Public Libraries required by the background program could not be 
loaded. The current background job is aborted. 

This alarm is output to OC after the system is booted from the RAD if the 
RBM Control Task interrupt cannot be triggered. 

A parity or transmission error has occurred on this device. Any automatic 
retries that were specified have been performed before this message was 
output. 

Device specified is in manual mode and may be out of paper, cards, or 
tape. 

Some condition on device type yy with physical device number ndd (hexa- 
decimal) has caused the device to become not operational. 

Indicated unit is write-protected. If a magnetic tape, insert the write 
ring and make the appropriate key-in to retry the operation. If a RAD is 
specified, an SY key-in is required before the RAD can be written on. 



TRAP HANDLER MESSAGES 

The following messages are output by the trap handler upon 
occurrence of the various traps if the user does not specify 
his own trap handling: 

!!MEM. PROT. ERR AT xxxxx 

!! PRIVILEGE INST. AT xxxxx 

HNONEXIST. ADD. AT xxxxx 

HNONEXIST. INST. AT xxxxx 

MUNIMPLE. INST. AT xxxxx 

!! STACK OVERFLOW AT xxxxx 

UARITH. FAULT AT xxxxx 



! IWDOG TIMER RUNOUT AT xxxxx 

MILL. PARAM., CAL AT xxxxx 

Note that the ! ARITH. FAULT AT xxxxx" message is output 
for the fixed point arithmetic overflow trap, the floating- 
point fault trap, and the decimal arithmetic fault trap. The 
" ! I ILL. PARAM., CAL AT xxxxx" message is output if a 
user program furnishes the Monitor an invalid parameter 
while attempting to use a Monitor function. 

JCP MESSAGES 

The messages itemized in Table 8 are output by the Job 
Control Processor on both the OC and LL devices. 
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Table 8. JCP Messages 



Message 


Meaning 


! ! BEGIN IDLE 


Job Control Processor has read a I FIN card, which completes a job stack. 




The background then goes into an idle state. Processing will resume on a 




new job stack following an unsolicited key-in of C. 


NBICKSMERR 


JCP Loader encountered a checksum or sequence error on a binary card during 


!!BI SEQ ERR 


the loading process. 


UBT OVERFLOW 


Insufficient Background Temp RAD space to execute the requested background 




program. The job is aborted. 


!!CC ERROR, BT OVERFLOW 


The file size input on an ! ALLOBT command is greater than the available 




Background Temp RAD space. 


! ICC ERROR, FG KEY-IN REQUIRED 


A request has been made to run a foreground program without previously 




inputting an FG key-in. The !RUN or ! ROV command must be reentered 




after the FG key-in is input. 


I ICC ERROR, ILL. 


An improper ! ALLOBT command was input to change a Background Temp (BT) 


RELOCATION OF BT 


scratch file that was designated as a "saved" file prior to this job step. 


!!CC ERROR IN ITEM xx 


An error exists in a JCP control command in the indicated item. Every item 




(except the ! character) followed by a blank or comma is counted in deter- 




mining the item in error. 


NEOT ON FILE xxxxxxxx 


End-of-Tape status was returned from an attempt to read or write the indicated 




RAD file. 


IIERR, CONTROL BYTE = xx 


JCP Loader is not equipped to process the indicated control byte. 


! I FGT FULL, CAN'T LOAD xxxxxxxx 


The indicated foreground program cannot be loaded because insufficient space 




exists in the Foreground Program Table. 


I ! FILE xxxxxxxx NONEXIST. 


The indicated RAD file was never allocated via the RAD Editor or was never 




written into. 


MILL. DEFINE FIELD ITEM 


JCP Loader has encountered a define field item that it is not equipped to 




handle. 


1 1 ILLEGAL BINARY CARD 


An EBCDIC card was read by the JCP Loader where a binary card was 




expected. 


MILL. EXPRESSION 


JCP Loader has encountered an expression that it is not equipped to evaluate 




(a mixed resolution expression). The load will be aborted. 


MILL. NEG. ORG ITEM 


JCP Loader has encountered an origin item that it is not equipped to handle 




(an origin item that moves the load location counter in a negative direction). 




The load will be aborted. 


1 1 JCP 


The JCP has just begun to read control commands. This occurs both at the 




beginning of a job and between steps within a job. If C is assigned to the 




typewriter or if "TY" override is in effect, the input light on the typewriter 




will indicate that RBM is ready for input of a control command. This message 




is output only to OC. 


! ! NOT ENUF SPACE FOR LOAD 


JCP Loader is unable to complete the load because of insufficient background 




space. 


IIPUB LIB, CAN'T LOAD xxxxxxxx 


The designated program on the [RUN command is a Public Library and cannot 




be executed via a [RUN command. 


MSCHING FOR JOB CMD 


The present job has been aborted and the JCP is searching the job stack for 




the next !JOB or I FIN command. 


MTOO MANY CONTROL SECT. 


JCP Loader has encountered more than one nonstandard control section. The 




load will be aborted. 


I1TOO MANY DCB'S 


The maximum number of M: and F: DCBs was exceeded during the loading 




process. Approximately 27 DCBs can be accommodated by the system. The 




excess DCBs will not be stored in the DCB table or the RAD file header. 
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Table 8. JCP Messages (cont.) 



Message 


Meaning 


MTOO MANY DEF/kEF'S 

! '.UNSATISFIED REF xxxxxxxx 

MUNSATISFIED REF'S DURING 
LOAD 


JCP Loader has encountered more than 255 declarations in the object module 
being loaded. 

Indicated REF was not satisfied during the loading process. This alarm occurs 
only on LL if no map was requested, or on LO if a map was requested. 

This message is typed to the operator on OC at the end of a load if any unsat- 
isfied REFs were encountered during the loading process. 



UNSOLICITED KEY-INS 

Unsolicited key-ins provide the operator a means of control- 
ling a background job or of loading for execution or re- 
leasing foreground programs. Note that any control the 
operator can exercise over the foreground is provided 
througli operator key-ins, so that foreground control is 
independent of the background job stack. 

The operator can initiate an unsolicited key-in at any time 
by depressing the INTERRUPT switch on the control panel 
console. This action causes the Control Panel Task to be 
activated; the Control Panel Task, in turn, triggers the 
RBM Control Task. When the RBM Control Task becomes 
the highest priority task in the system (that is, when all 
foreground tasks are inactive), the message 

!! KEY-IN 

will occur on the OC device. 

All operator responses will terminate with a NEW LINE 
code. A blank (i.e., space) is used as a field delimiter, 
and any number of blanks can be used to separate fields. 
A message can be deleted prior to the NEW LINE input 
by depressing the End-of-Message key. 

The analysis and subsequent action from an unsolicited key- 
in is performed at the RBM Control Task priority level. If 
the operator response is not recognized as a valid input, 
the message 

HKEYERR 

is output on OC. In this case, the operator should retype 
the response. Note that if the typewriter is busy at the 
time of the Control Panel Interrupt (i.e., waiting for an 
input to complete), the operator must complete the input 
before the !! KEY-IN type-out can occur. 

The specific responses to the !! KEY-IN type-out are listed 
in the following sections. All key-ins can be preceded by 
an optional exclamation mark. 

" The Continue key-in directs the Monitor to either 

start processing the background job stack or to continue 
processing in the background. The C key-in will end an 
idle state or will continue a job after the job was discon- 
tinued by a wait key-in, wait system call, or PAUSE con- 
trol command. 



The C key-in has the form 

c © 

COC The Continue from OC key-in is used to correct 

an errored control command from the OC device. If a 
processor reads an incorrect control command during an 
attended run, the WAIT state will be entered. For some 
processors such jas^the Overlay Loader and RAD Edilor, the' 
contro l command in error can be reinput fromOC via the 
COC key-in after _[nterrupting out of J^e_WALT_st°l e -_ After 
correcting the command in error, control will be transferred 
back to the C device. 

The COC key-in has the form 

COC© 

W The Wait key-in causes the current background job to 

be discontinued and enter a WAIT state. 

The W key-in has the form 

W © 

X The X key-in will abort the background job with any 

dumps that were requested. A message will be printed on 
OC and LL which shows the last background location that 
was executed. 

The X key-in has the form 

X© 

SY The SY key-in allows any RAD file to be written 

into by a background program by providing the operator a 
means of overriding the normal software protection of RAD 
files. The SY key-in is cleared by a JOB command. 

The SY key-in has the form 
SY© 

TY _ The TY key-in causes the C operational label to be 
assigned to the OC device. The next and all ensuing con- 
trol commands will be read from OC. Control will be re- 
turned to the C device on a CC control command or key-in. 

The TY key-in has the form 
TY © 
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CC_ The CC key-in is used in conjunction with the TY 
key-in and transfers control back to the C device by re- 
assigning the C op label to its previous assignment. 

The CC key-in has the form 

| CC © 

DT The DT key-in is used to inform the Monitor of the 

current date and time. 

The DT key-in has the form 
I DT month, day, year, hour, minute © 



/here 

month 

day 

year 

hour 

minute 



specifies the current month (1Smonth<12). 
specifies the current day (lsdays31). 
specifies the current year (00syears99). 
specifies the current hour (0shours23). 

specifies the current minute (Os minutes 59). 



RUN The RUN key-in is used to load and initiate a fore- 

ground program. The program will be loaded at the priority 
of the Control Task if the space required for execution of 
the program is available. If the space is not available, an 
alarm will be typed and the operator will have to retype the 
RUN key-in when the space is available. 

The form of the RUN key-in is 
I RUN name © 

where name is the file name of the foreground program to 
be loaded. The program must exist in core image format in 
the Foreground Programs area erf the RAD. 

A MKEY ERR type-out will occur from this key-in if the 
requested program is already loaded or if space was not 
available in the Foreground Program Table. 

RLS The RLS key-in is used to release a foreground pro- 

gram. The interrupts associated with the program are dis- 
armed and after I/O has run down for the program, the 
memory space occupied by the program is marked as not 
used. 

The RLS key-in has the form 

I RLS name © 

where name is the file name of the foreground program to 
be released. 

STDLB The STDLB key-in is used to change the perma- 

nent assignment of an operational label. For a "C" op- 
erational label, both the permanent and temporary 
assignments are changed, unless the "C" label is assigned 
to zero. In this case, only the temporary label is changed. 
The assignment will stay in effect until the system is re- 
booted from the RAD. 



The STDLB key-in has the form 

STDLB label [, area], name © 

where 

label specifies one of the standard operational 

labels that was input during SYSGEN. 

area specifies a RAD area for the case of assign- 

ment of an operational label to a RAD file. If the 
operational label is being assigned to a file in the 
BT area, the "area" input is optional. 

name specifies a physical device name to which the 

operational label is to be permanently assigned, a 
numeric zero, the name of a RAD file, or another 
operational label. In the latter case, the first op- 
erational label will receive the same assignment as 
the permanent assignment of the second operational 
label. If "0" is specified, there is no permanent 
assignment, which means that all output is sup- 
pressed to that label. 

INTLB The INTLB key-in is used to change the assign- 

ment of interrupt labels specified at SYSGEN time. 

The INTLB key-in has the form 

INTLB label, loc © 

where 

label specifies one of the interrupt labels defined at 

SYSGEN time. 

loc specifies the new absolute hexadecimal loca- 

tion to be associated with the label. The location 
n must be 58i / SnSy, where y is the highest in- 
terrupt location specified at SYSGEN. 

CINT The CINT key-in is used to disarm, arm and en- 

able, or trigger a specified interrupt. 

The CINT key-in has the form 



_ IKIT {location 
CINT t label 



)■ 



© 



location specifies the hexadecimal address of the 

interrupt to be modified. The location n must be 
58| < n S y, where y is the highest interrupt lo- 
cation specified at SYSGEN. 

label specifies an interrupt label. 

D disarm the specified interrupt. 

A arm and enable the specified interrupt. 

T arm and enable, and trigger the specified 
interrupt. 

Note that the location being acted upon must contain an 
XPSD instruction or the request will be rejected. 
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FMEM The FMEM key-in is used to change the boundary 

between background and foreground memory. The key-in 
will not take effect until the current background job step 
completes. 

The FMEM key-in has the form 
FMEM [n] © 

where n specifies the number of pages to be allocated to 
foreground memory. If n is less than the present foreground 
allocation, no active foreground programs can exist in the 
area being released. If the foreground area is not free, an 
alarm (! !FGD AREA ACTIVE) will be typed, If n is zero, 
the entire foreground area will be allocated to the back- 
ground. The default case will be to allocate the number of 
pages specified during SYSGEN. 

FC The FG key-in allows a foreground program to be 

loaded for execution from the background job stack via a 
RUN control command, and protects the foreground from 
inadvertently being destroyed by an error in the background 
job stack. The FG key-in must precede the RUN control 
command or the background job will be aborted. 

The FG key^in has the form 
FG © 

COMBINED KEY-INS To facilitate the key-in process, 

the following combinations of key-ins are allowed: 

Combined Form Result 

FGC Executes the FG and C key-ins 

SYC Executes the SY and C key-ins 

SFC or FSC Executes the FG, SY, and C key-ins 

TYC Executes the TY and C key-ins 

DM, DB, DF The Dump Monitor (DM), Dump Background 

(DB), and Dump Foreground (DF) key-ins allow the user to 
dump the contents of core memory onto the device that is 
permanently assigned to the DO operational label. 

These key- ins have the form 



DM 

DF 

DB 



[from, to] © 



DED The DED key-in allows a device and, optionally, 

all other devices on the same IOP to be dedicated to the 
foreground or to IOEX. 

The DED key-in has the form 



DED yyndd j^} [,I] © 



vhere 



yyndd is the name of the device to be dedicated 

(e.g., CRA03, DCAFO, etc.). 



B 



specifies the device is to be dedicated to the 
foreground (F) or to IOEX (X). 

specifies all devices on IOP n (n of yyndd) are to 
be dedicated. If I is absent, only the one device 
for a single unit controller is dedicated, or all de- 
vices on the same multiunit controller arededicated. 



UND The UND key-in undedicates a device or IOP that 

was previously dedicated through a DED key-in. If the de- 
vice was dedicated to IOEX, it should be undedicated from 
IOEX by using the X option. 

The UND key-in has the form 



UND yyndd {^j [,l] © 



•here 



yyndd is the name of the device to be undedicated 

(e.g., CRA03, DCAFO, etc.). 

j | specifies the device is to be undedicated from 
the foreground (F) or from IOEX (X). The same 
option that was used in dedicating the device 
should be used in undedicating the device. 

I specifies that all devices on IOP n (n of yyndd) 

should be similarly undedicated. 



DIRECT I/O COMMUNICATION 

If the Monitor encounters an abnormal condition during an 
I/O operation, a pertinent message to the operator is output 
on the OC device. Such a message is of the form 

! ! name message 



If the [from, to] field is absent, DM causes the entire Moni- 
tor area of memory to be dumped; DB causes the entire, cur- 
rently defined background area to be dumped; and DF causes 
the entire, currently defined foreground area to be dumped. 
The presence of the [from, to] field indicates the first word 
address and last word address (in that order) of memory that 
is to be dumped. If the [from, to] field is present, any of 
the three key-ins (DM, DF, or DB) can be used to achieve 
the same result, since only the specified locations are 
dumped. The last word address must be equal to or greater 
than the first word address. 



where 



name is the physical device name (see "ASSIGN", 

Chapter 2). 

message is the message string informing the oper- 

ator of the specific condition that has been detected. 
For example: 

ERROR (error was defected on operation) 



MANUAL (device not ready) 
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Monitor I/O messages are discussed below, grouped accord- 
ing to the type of device to which they apply. 

After correcting the abnormal conditions, the operator re- 
sponds by means of a key-in. 

The format for an I/O key-in is 

name a © 

where 

name is the physical device name of the device 

involved in the I/O operation. 

a specifies a Monitor-action character (see Table 9). 

© is the NEW LINE code. 

Table 9. Monitor Actions 



a 


Monitor Action 


C 

E 

R 


Continue "as is". 

Inform the user program of the error and 
transmit record "as is". 

Repeat the I/O operation. 



CARD READER 

If the card reader fails to read properly, or if a validity 
error occurs, the Monitor outputs the message 

! ! CRndd ERROR 

on the OC device. After correcting the condition, the 
operator responds with an I/O key-in message. The action 
character selected (see Table 8) depends on the circumstances. 

If a feed check error or a power failure occurs, theMonifor 
outputs the message 

!! CRndd ERROR 



HCRndd TIMED OUT 

on the OC device, depending on where in the cycle the 
error took place. If the card in the hopper is damaged, the 
operator replaces it with a duplicate, presses the RESET 
button on the card reader, and responds to the Monitor with 
the key-in 

CRndd R © 

In the event of a power failure, the operator presses the 
RESET button on the card reader and responds to the Monitor 
with the key-in 

CRndd R © 

If the card stacker is full, if the hopper is empty, or if 
the device is in the manual mode, the Monitor outputs the 
message 

!! CRndd MANUAL 



on the OC device. The operator corrects the condition 
and then presses the START button on the card reader. 



CARD PUNCH 

Instead of outputting an error message when a punch error is 
first detected, the I/O handler attempts to punch a card 
x times (x - NRT, a DCB parameter specified by the user; 
see Chapter 4) before outputting the message 

! ! CPndd ERROR 

on the OC device. The above message indicates that the 
card punch is not functioning properly, and the operator 
should reevaluate the job stack based on this knowledge. 
Improperly punched cards are routed to an alternate stacker. 

If the input hopper is empty, the stacker is full, or the chip 
box is full (some machines), or if the device is in the manual 
mode, the Monitor outputs the message 

!! CPndd MANUAL 

on the OC device. The operator corrects the condition and 
presses the START button on the card punch. 

If a power failure or a feed check error occurs, the Monitor 
outputs the message 

I ! CPndd ERROR 



! ! CPndd TIMED OUT 

on the OC device, depending on where in the cycle the 
error took place. If the card in the hopper is damaged, the 
operator removes it, presses the RESET button on the card 
punch, and responds to the Monitor with the key-in 

CPndd R© 

In the event of a power failure, the operator presses the 
RESET button on the card punch and responds to the Monitor 
with the k ey-in 



CPndd R © 



PRINTER 



When an irrecoverable print error is detected, the Monitor 
outputs the message 

!! LPndd ERROR 

on the OC device. The I/O handler attempts to print a 
line x times (x = NRT, a DCB variable specified by the 
I/O user; see Chapter 4) before outputting the above mes- 
sage. The operator's response after correcting the condition 
depends on the specific device and circumstances. 

If the printer is out of paper, if the carriage is inoperative, 
or if the device is in the manual mode, the Monitor outputs 
the message 

! ! LPndd MANUAL 

on the OC device. The operator corrects the condition and 
presses the START button on the line printer. 
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If the line printer power is off, The Monitor outputs the 
message 

!! LPndd UNRECOG 

on the OC device. The operator should correct the condi 
tion and respond with the key-in 

LPndd R© 



PAPER TAPE READER 

If an error occurs during the reading of paper tape, the 
Monitor outputs the message 

! ! PRndd ERROR 

on the OC device. After correcting the condition, the op- 
erator responds with an I/O key-in message. The action 
character selected depends on the circumstances. 



PAPER TAPE PUNCH 

If the paper tape punch is out of paper, the Monitor out- 
puts the message 

! ! PPndd MANUAL 



on the OC device. The operator corrects the condition and 
depresses the START key. 

If the paper tape punch is off-line or the power is off, the 
Monitor outputs the message 

!! PPndd UNRECOG 

on the OC device. The operator corrects the condition and 
responds to the Monitor with the key-in. 

PPndd C or R © 



MAGNETIC TAPE 

If an error occurs during the reading or writing of magnetic 
tape, the Monitor I/O handler attempts a recovery x times 
(x = NRT, a DCB variable). If the error is irrecoverable, 
the user is informed via an error return. 

If a magnetic tape is addressed and there is no physical reel 
or power, the Monitor will output the message 

!! MTndd UNRECOG 

on the OC device. The operator's key-in response depends 
on the circumstances. 
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4. INPUT/OUTPUT OPERATIONS 



The RBM I/O system provides the user with the capability 
of performing input/output operations on standard XDS pe- 
ripheral devices. An I/O request is made through execu- 
tion of a CAL1 instruction that addresses a Function Param- 
eter Table (FPT), which in turn is a list of parameters that 
define the request. The FPT addresses a Data Control Block 
(DCB), which is a list of parameters that define the nature 
of the data file. The DCB then addresses a Device Control 
Table (DCT) entry or a RAD File Table (RFT) entry, depen- 
ding upon whether the data file concerned is associated 
with a non-RAD peripheral device or a RAD file. The DCT 
entry contains the device status parameters, and the RFT 
entry contains the RAD file parameters. 

The CAL1 instruction and FPT must be generated at assembly 
or compilation time. Symbol or Macro-Symbol users must 
include both the CAL1 and the FPT in the source code. For 
FORTRAN users, the compiler generates the necessary CALls 
and FPTs. 

All DCBs are given names beginning with M: for system 
DCBs or F: for user DCBs. The DCBs may be included in 
the source code if desired. If not included, the Overlay 
Loader generates the DCBs necessary to satisfy any unsatis- 
fied references to F: or M: DCB names. System DCBs gen- 
erated by the Loader have default parameters; User DCBs 
generated by the Loader are left blank. 

The correspondence between a DCB and either a device or 
RAD file can be established by using the ! ASSIGN control 
command. Other DCB parameters describing the data file 
may also be set by the ! ASSIGN control command. 

Two types of Read/Write requests are provided. Type I re- 
quests have the completion status posted in the DCB. The 
disadvantage of this type of I/O operation is that a DCB 
cannot be shared among requests in different tasks because, 
in general, it is impossible to associate the completion status 
in the DCB with a specific request. For this reason, Type II 
requests are provided. 

Type II requests result in the completion status being posted 
in the FPT associated with the request. This enables several 
requests (perhaps in several tasks) to be in progress simulta- 
neously on a given DCB. Type II requests require that the 
associated FPT must be in memory and not in a register. 

The CHECK function tests for the completion of READ/ 
WRITE requests that are performed without waiting for com- 
pletion. CHECK tests the completion status posted in 
the DCB (Type I requests), or FPT (Type II requests). 



PERMANENT RAD FILES 



Permanent files are defined through the RAD Editor by use 
of the :ALLOT command, and data can be entered through 



the RAD Editor or any program that uses the system I/O. 
At definition time, the following file parameters are 
given by the user: 

File name (maximum 8 characters) 

File organization (blocked, unblocked, compressed) 

Record size (for blocked or unblocked files to be ac- 
cessed sequentially) 

Granule size (for files to be accessed directly) 

File size 



TEMPORARY RAD FILES 

Temporary files are in the Background Temp area of the 
RAD and have the fixed names Xj (1 < i s 9), GO and OV. 
The size for these files can be set by using the ! ALLOBT 
control command. If no ! ALLOBT control command ap- 
pears within a user job, the files assume default sizes that 
are set by the Job Control Processor. The files X: should be 
considered as primarily for temporary use within a single 
job step, since they are all allocated from a single area 
with X; + ] beginning just above X-. Therefore, changing 
the size of a file X| can cause a change in location of files 
X : for ; > i. GO and OV are a I located from the top of the 
temporary file area downward. A change in the size of files 

X. therefore has no effect on the RAD position of these files. 
i 

Since the size and location of temporary files can be changed 
through background job control commands, they must not be 
used by foreground programs. 



FILE ORGANIZATION 



BLOCKED FILES 

Blocked files contain fixed length records whose length is 
less than or equal to 128 words. In blocked files, the 
largest possible integral number of records is combined into 
256-word blocks. These blocks are basic units of data trans- 
mitted to and from the RAD. As sequential READ requests 
are made to a blocked RAD file, the blocks are read from 
the RAD into blocking buffers as necessary, and the data 
records are transmitted to the user's input buffer. 

Blocked organization is specified for a file when the file is 
defined by the RAD Editor. A file specified by the user as 
blocked, but having a record size greater than 128 words, 
will be given unblocked organization. 

UNBLOCKED FILES 

Unblocked files contain records of fixed length, each of 
which begins on a sector boundary. Each record requires 
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some integral number of sectors that is the smallest possible 
integral number that can contain the record. 



COMPRESSED FILES 

Compression of EBCDIC data in RAD files is provided by 
RBM by the removal of blank characters, since many blanks 
occur in a typical programming language source code. Com- 
pressed files are blocked into 256 word blocks on the RAD 
and the records are of variable length. No record crosses 
a block boundary. 



ACCESS METHODS 



are queued by order of occurrence. The queues are chains 
of entries representing requests for actual I/O operations on 
devices. There is a single pool of free entries for all de- 
vices, and these entries are removed from the poo! and linked 
to the controller queues as needed. The queue entry is re- 
turned to the free entry pool when a queued request is 
completed. 

At System Generation, the user may specify the maximum 
number of entries to be used for background requests to 
ensure that the background does not tie up all the queue 
entries, thus causing foreground requests to wait. Whenever 
a request is made and the free entry pool is empty (all queue 
entries in use), the request is made to wait until an entry 
is freed. 



SEQUENTIAL ACCESS 

The sequential access method provides record-by-record 
access to the file in the same way that a data file on 
magnetic tape is accessed. A sequential access READ/ 
WRITE request results in the next record in sequence being 
read or written. Sequential access can be used on blocked, 
unblocked, or compressed files. 



DIRECT ACCESS 

In the direct access method, the user furnishes the relative 
granule number of the start of the READ/WRITE request and 
the number of bytes to be transferred. The user is respon- 
sible for the organization of the file, including discrimina- 
tion of logical records, maintenance of a key structure 
within the file, etc. Addressing files by granules allows 
the direct access method to be independent of the RAD sec- 
tor size. Granule size is specified by the user at file crea- 
tion. Each granule begins on a sector boundary, and the 
RAD space between granule end and the beginning of the 
next sector is never involved in direct access to the file. 

The user is not restricted to I/O operations whose length is 
less than or equal to the granule size. For requests of 
length greater than granule size, the I/O system chains 
I/O operations to effect a skip of the dead space. 

I/O QUEUEING 

The I/O system provides for queueing of all requests to I/O 
devices. That is, any I/O request ( READ, WRITE, REW, 
etc.) requiring a device to be accessed results in the re- 
quest for the specific access being queued. 

Device requests are queued on a controller basis (one queue 
per controller), and they are queued in order by priority of 
the task making the request. For example, a READ request 
to a card reader will be placed in the queue for the speci- 
fied card reader controller, and its position in the queue is 
determined by the priority of the requesting task and the 
relative priorities of the requests already in the queue. Re- 
quests for a designated device from a specified priority level 



I/O CLEANUP AND I/O START 

I/O Cleanup is the data processing performed between com- 
pletion of the actual data transmission (signaled by occur- 
rence of the I/O interrupt) and the completion of the re- 
quest. It includes such functions as error testing, setup 
for error recovery, posting of completion status in the FPT 
or DCB, setting of indicators in the DCT, dequeueing the 
completed request, etc. 

I/O Start is the operation of starting a device for the next 
request. 

Under the RBM I/O system, CPU time is not taken from a 
task to perform data processing for lower priority tasks; in- 
stead, I/O Cleanup and I/O Start functions are performed 
at the various times and priority levels given below: 

1. I/O Cleanup is performed at I/O interrupt time if 
either the current request or the highest priority re- 
quest in the queue for the same device controller are 
from tasks of higher priority than that of the interrupted 
task. If I/O Cleanup is performed at this time, I/O 

x Start will be performed if the highest priority request 
in the queue is from a task of higher priority than the 
interrupted task. 

2. If a CHECKed request was not previously completed, 
the CHECK system instigates I/O Cleanup and I/O 
Start on the specified controller through to completion. 
The CHECK system performs at the priority of the 
CHECKing task. 

3. At request time, I/O Cleanup and I/O Start are per- 
formed as necessary to satisfy the request at the priority 
level of the requesting task. 

For an I/O request with wait, the device is driven un- 
til the request is completed. I/O Cleanup and I/O 
Start are instigated as needed. 

For an I/O request with no wait (after queueing the 
request by priority), I/O Cleanup is performed if the 
device and controller are not busy. The device is thus 
made busy before control is returned to the user. 
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At the Control Task level, any I/O Cleanup or I/O 
Start that was deferred because of priority considera- 
tion at I/O interrupt time (item 1 above) is performed. 



SHARING DCBs AMONG TASKS 

DCBs can be shared among several tasks within a given pro- 
gram, subject to the restriction that no task can make a 
Type I request on a DCB that is busy with another Type I 
request. 

DCBs explicitly referenced by the user are allocated and 
created by the user either in the source code (for Symbol 
and Macro-Symbol), the compiler, or the Overlay 
Loader. This means that each program has a private copy 
of all DCBs explicitly referenced, and no DCBs are shared 
among programs. The user program has the responsibility 
for coordinating the Open and Close functions for DCBs 
shared among tasks within a program. An Open request 
results in the DCB being opened if it is not already open. 
A Close request causes the DCB to be closed if it is not 
already closed. No attempt is made to balance Open and 
Close requests for a DCB to determine which Close request 
should actually cause the DCB to be closed. 

SHARING I/O DEVICES AMONG TASKS 

Any number of tasks within a given program can share any 
device by sharing a DCB assigned to the given device. For 
sequential type devices (i.e., card reader, card punch, 
line printer, magnetic tape, paper tape reader, paper tape 
punch), responsibility for positioning and/or determining 
the position of the device is left to the user. No attempt 
is made to analyze a request on a DCB to determine which 
task has made the request. 

Sequential output devices (i.e., card punch, paper tape 
punch, line printer, magnetic tape), can be shared by 
tasks (possibly in different programs) that use different DCBs. 
If several DCBs are assigned to an input or output device 
such as a magnetic tape drive, only write requests may be 
made through these DCBs. The sharing of output devices 
by different programs using different DCBs is used for log- 
ging error conditions or alarms. 



Sequential input devices (i.e., card reader, paper tape 
reader, magnetic tape) cannot have different DCBs as- 
signed to them. Sharing of these devices must be accom- 
plished through real-time requests on a single DCB. For 
example, a background user who wishes to use double buf- 
fering on a card reader can do so by using two real-time 
Read requests with two different FPTs. 

Random access devices such as RADs can be shared, using 
direct access, by tasks within different programs using vari- 
ous DCBs. The sharing can be performed without restric- 
tion other than those restrictions normally imposed on 
tasks sharing a DCB. 



As DCBs are opened and closed, a count of the DCBs that 
are open and assigned to a device is kept. This count is 
incremented for every open request on a DCB assigned to 
the particular device, and is decremented for each Close 
request. 



SHARING RAD FILES AMONG TASKS 

Any number of tasks within a program can share a RAD file 
by sharing a DCB assigned to the file (subject to the condi- 
tions placed on tasks sharing DCBs discussed previously). 
A RAD file shared in this manner can be accessed either 
sequentially or directly. Input/output Requests are allowed. 

Tasks can share a RAD file using different DCBs with the 
restriction that no sequential input or blocked sequential 
output requests can be allowed on a file shared in this man- 
ner. A count of the number of DCBs opened and assigned 
to a RAD file is kept for each file. If the count is greater 
than one, no sequential input from or blocked sequential 
output to the file is allowed. 

An Open request on a DCB assigned to a RAD file results in 
opening of the file if it is not already open. A Close request 
on such a DCB results in closing of the file only if the 
"Open DCB Count' for the file is 1. 



I/O END ACTION 

Foreground programs (for READ, WRITE, and IOEX requests) 
may use I/O end-action. Two types of end-action are 
possible: 

1. The user provides an end-action address in the FPT. 
A transfer to this address will be made following the 
occurrence of an I/O interrupt that signals completion 
of the data transfer. This end-action transfer is made 
by executing 

BAL, 11 end-action address 

with the CPU in master mode, the I/O interrupt still 
active, and the AIO status in register 5. The end- 
action may destroy any registers except 5, 7, and 11. I 
Return from the end-action routine must be made by 

B * 1 1 

with the CPU still in master mode, the I/O interrupt 
still high, register 5 containing the AIO status, and 
register 7 containing the device type index (DCT). 

It should be noted that since end-action is performed 
with the I/O interrupt high, all tasks whose priority 
is lower than that of the I/O interrupt task are effec- 
tively disabled for the duration of the end-action. 

Since the end-action user can seriously degrade in- 
terrupt response for lower priority tasks, it is strongly 
recommended that this type of end-action not be 
used for applications where other techniques are 
satisfactory. 
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2. The user FPT contains either an interrupt number or 
interrupt label specifying a system interrupt. The sys- 
tem interrupt is triggered upon occurrence of an I/O 
interrupt that signaTs completion of the request {this 
interrupt will be triggered before the I/O interrupt is 
cleared). The task connected with the specified inter- 
rupt then performs the end-action function at the pro- 
per priority level. The user is responsible for connecting 
the interrupt and ensuring that it is armed and enabled. 

If th e en d n trti n n i o terr up t pri ority ha a-tW^ema-pflor- 

ilj i i n ih ii i| ilwij i n I l i rrntrrTiir i i iii|i i I nl i|i|i nil 

"The I/O system sets a flag in the TCB to indicate that 
the trigger has been performed. The EXIT routine in- 
terrogates this flag before performing the EXIT for cen- 
trally connected tasks. If the flag is set, the occur- 
ence of the interrupt (previously lost by the triggering 
of an active interrupt) will be simulated. Directly 
connected tasks using this type of end-action assume 
the responsibility for solving problems of this type. 

No end-action is taken for requests that do not require 
actual device access (1. e., READ on a blocked RAD 
file that does not require reading a block from the 
RAD); however, end-action will be performed for re- 
quests that cause a device access and an I/O interrupt. 



RESERVING I/O DEVICES FOR FOREGROUND USE 



I/O devices can be reserved for exclusive use of the fore- 
ground program system through SYSGEN input, operator 
key-in, or through a system call from a foreground program. 
Reservation can be made either for a specific device or for 
all devices associated with a given IOP. A reservation for 
a device on a multidevice controller results in reservation 
of the entire controller. When a device is reserved, it is 
specified either that all foreground requests for the device 
will be allowed, or that only foreground direct access 
(IOEX) requests will be allowed. 



Device reservation results in all background requests to the 
device being held in abeyance until the device is released 
for background use. The background user program is un- 
aware that execution is suspended. 



When devices are reserved for IOEX operation only, all 
regular (READ, WRITE, etc.) requests from the foreground 
are also held in abeyance. A foreground program making 
such a request will be pending in the I/O system until the 
device is released for regular foreground use. In IOEX 
reservation mode, the foreground task doing IOEX I/O 
and the task that eventually releases the device for regular 
foreground use must be of higher priority than any task doing 
standard I/O. This type of device reservation is designed 
for the user with a high throughput foreground application 
who needs to guarantee that a device (typically the RAD) 
is immediately available and is not in the process of an 
I/O operation for another task. 



A count is kept of the number of reservations (STOPIO re- 
quests) of each type (either all foreground I/O allowed or 
IOEX only al lowed) for each controller. As devices are 
reserved, the proper count is incremented, and as they are 
released, the count is decremented. A value greater than 
zero indicates that the controller is reserved. The user must 
balance each STOPIO request with a STARTIO request so 
the system can maintain order. 

When I/O requests are received by the system, the reserva- 
tion counters are tested to determine whether the request is 
allowed. Any request not allowed because of a STOPIO re- 
quest will not be queued. Any request previously queued 
but currently not allowed will not be started. 

The foreground user can specify in a STOPIO request that 
the in-process operation on the specified controller be 
aborted through execution of an HIO. 



DIRECT I/O EXECUTION (IOEX) 

RBM provides the foreground user with the capability of 
programming I/O devices by furnishing TIO, TDV, HIO and 
SIO instructions, and IOP command doublewords. The in- 
structions are executed by the I/O system. Status informa- 
tion resulting from the instruction execution is returned to 
the calling task for analysis. No testing or error recovery 
is performed by the system. 

Prior to performing IOEX operations on a device, the device 
must be reserved for IOEX operation only. This requires the 
user to issue a STOPIO unless it is known that the device 
was properly reserved either during SYSGEN or by the 
operator. 

For SIO requests, if a user wishes to be informed of the occur- 
rence of the I/O interrupt, it is imperative that the command 
doublewords be set up so that a channel end interrupt occurs. 

The SIO request may also include an end-action address or 
an end-action interrupt number. This address is the entry to 
the user's routine that will analyze the resultant status and 
set appropriate indicators. It should be noted that the user's 
routine is entered with the I/O interrupt active, and to avoid 
seriously degrading system interrupt response, the routine 
should require as little execution time as possible. Control 
is transferred to the end-action routine through a 

If an end-action interrupt number or interrupt operational 
label is given, the interrupt will be triggered upon comple- 
tion of the operation signaled by the I/O interrupt. This in- 
terrupt must be connected to the end-action task. 

IOEX cannot be used by background programs. The require- 
ment that background programs be able to read any data writ- 
ten by foreground programs is satisfied by the facility to 
treat an entire RAD area as a single-file fordirect access in- 
put (see discussion of IOEX system call later in this chapter 
fordetailsof the calling sequences and formats involved). 
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OPERATIONAL LABELS 



Under RBM, operational labels are used to lend flexibility 
in the assignment of DCBs to peripheral devices. Opera- 
tional labels represent logical devices and are assignable 
to physical devices and RAD files. 



I The system DCBs are defined in Table 10. 



I 



Table 10. System DCBs 



DCB Name 


Op Label or RAD 
Fi le Assignment 


Comments 


M:C 


C 


The first 12 DCBs 


M:OC 
M:LO 


OC 
LO 


are assigned to 
the standard op- 
erational labels. 


M:LL 


LL 




M:DO 


DO 




M:CO 


CO 




M:BO 


BO 




M:CI 


CI 




M:SI 


SI 




M:BI 


BI 




M-SO 


SO 




M:PL 


PL 




M:Xi(l s j <9) 


Xi 


DCBs for Back- 
ground Temp 
scratch file. 


M:GO 


GO 


DCB to write on 
GO file. 


M:OV 


OV 


Output DCB for 
Overlay Loader. 


M:SL f 


Appropriate 
program file 


Input DCB for 
Segment Loader. 


The M:SL DCB does not have to be referenced by a 
program using overlays, since this DCB is automati- 
cally furnished by the Overlay Loader for any program 
with overlay segments. 



3. 



DCBs are distinguishable by the prefix "M:", and such 
DCBs are assigned to system operational labels (see the 
"Overlay Loader" chapter). 

! ASSIGN control commands can be used to assign DCBs 
to system operational labels (see the discussion of 
I ASSIGN control command in Chapter 2). 



Operational labels are assigned to physical devices or RAD 
files. Each operational label has two assignments, tempo- 
rary and permanent. The permanent assignment is used by 
all foreground programs and serves as a default for the tempo- 
rary assignment. The temporary assignment is used by all 
background programs. Assignment of operational labels to 
devices or RAD files is made in the following ways: 

1. At System Generation, permanent assignments are made 
and remain in force until changed through STDLB key- 
in. The original permanent assignments are reinstated 
whenever the system is again booted and initialized. 

2. The STDLB key-in can be used by the operator to change 
the permanent assignment of an operational label, 
which will result in a corresponding change in the tem- 
porary assignment when the next JOB card is read. 

3. The ! STDLB control command can be inserted by the 
user to change the temporary assignment of an oper- 
ational label. 

Temporary assignments remain in force only within a single 
background job. Each I JOB control command causes the 
temporary assignments to be set the same as the permanent 
assignments except for the "C" operational label. Should 
temporary assignments be changed by an ! STDLB control 
command, the new assignment remains in force only for the 
duration of the job except for the "C" operational label. 

At System Generation, the user may specify any number of 
optional operational labels, with the proviso that the op- 
tional labels be two characters in length. For each optional 
operational label, an entry is built in the operational label 
table, and each entry requires four bytes of system residence. 

The relationship of system operational labels to their table 
index values is defined in the DCB description. The user 
assumes responsibility for determining the index values as- 
sociated with any optional operational labels created at 
System Generation. 



DCBs can be assigned to operational labels, physical de- 
vices, or RAD files. Assignment of DCBs to operational 
labels is accomplished in one of the following ways: 

1. The user can effect the assignment through the source 
code by allocating and defining the DCB, providing 
the operational label table index value (see "DCB 
Creation"), and specifying that the assignment is to 
an operational label. 

2. The Overlay Loader provides each program with a copy 
of all system DCBs referenced by the program. These 



DCB CREATION 

The Overlay Loader creates the DCBs for FORTRAN IV-H 
programs that reference the standard FORTRAN operational 
labels 10£*106,for their I/O requests. For other labels, the 
user must create DCBs using I ASSIGN control commands 
and machine language subroutines. 

DCBs for Symbol and Macro- Symbol programs are al located 
and defined in the following ways: 

1. User Created DCBs: The user may create his DCBs in 
the source code. The parameters defined at source 
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time may be overridden by ! ASSIGN control commands 
if the user follows the convention of defining the name 
of a DCB and beginning the name with F:. 

Warning: DC 8s will not receive any memory protec- 
tion, and assembly language users should exercise ex- 
treme care to prevent accidental alteration. 

Loader Created DCBs: At the conclusion of the object 
module load and the library search and load, the Loader 
creates DCBs for any unsatisfied REFs beginning with 
M: or F^. For REFs to system DCBs (M:), a copy of the 
standard, DCB is included in the root portion of the load 
module. I This DCB contains standard system parameters, 
including standard assignment to a system operational 
label. For example, M:LO is assigned to operational 
label LC>.. User DCBs (F:^ are included in the load mod- 
ule but Jmk'f qre'letrbranfc. The background user must 
define the parameters for F: DCBs through J ASSIGN 
control commands. Definition and assignment of F: 
DCBs in foreground programs can be made through 
Overlay Loader control commands. 

! ASSIGN Command Created DCBs: ! ASSIGN control 
commands can create DCBs in addition to defining or 
redefining parameters in existing DCBs. This DCB crea- 
tion facility enables FORTRAN IV-H programs to per- 
form I/O using variables as operational labels. At 
run-time, the FORTRAN program evaluates such vari- 
ables, converts the variable value to a DCB name and 
locates the DCB. For example, a FORTRAN variable 
with value 101 would result in an I/O operation using 
DCB F : 1 1 . The DCB must have been created in a 
Symbol or Macro-Symbol subroutine or through an 
! ASSIGN control command. 



DCB FORMAT 

The format for a Data Control Block is given below: 

word 



vord 4 



TTL 



m 



oo 



000 

III 12 13 



ooojp 



00 



14 151 16 17 16 191 20 21 22 23 



00 BTD 



24 25 26 27 



ASN 



29 30 3t 



word 1 



NRT 



1 2 3 14 5 6 7 




TYPE 



16 1? 16 19T20 2t 22 23 



DEV/OPLB/RFI IE 



24 2; 26 27l 26 29 30 31 



word 2 









TYC 


BUF 


12 3 14 5 6 7 


8 9 10 111 12 13 14 


15116 17 18 19(20 21 22 23l24 25 26 27 1 28 29 30 31 



3rd 3 



RSZ 



ERA 



ARS 



ABA 



Ttl 5 6 7 I B 9 10 111 12 13 14 151 16 17 18 19l 20 21 22 23 1 2-4 25 26 27 1 28 29 30 31 



Word 



TTL is the total length of the DCB. A length of 

seven words is required by any DCB which may be 
assigned to a RAD file. A length of five words is 
sufficient for DCBs that are assignable only to de- 
vices or operational labels, 

TTL must be set by the mechanism creating the 
DCB; either by the user (through the source code). 
Overlay Loader (when the user declares the name 
but does not create the DCB), or by the ! ASSIGN 
control command which creates the DCB. 

OPEN is the DCB open indicator. It must be set to 

zero before the DCB is opened. The I/O system 
sets the indicator to 1 when the DCB is opened. 

MOD is the mode flag (0 for EBCDIC mode; 1 for 

binary). The flag is set at DCB creation time and 
its status may be changed by I ASSIGN control 
commands or through a Device Mode system call. 
This flag has meaning only for I/O requests to 
7-track magnetic tape, card punch, or card reader. 
For requests to read a card reader, Mode flag 
causes a Read Automatic. Input from a card 
reader designated as the C device is always per- 
formed in automatic mode (mode flag is ignored). 

BUSY is the DCB busy indicator that is set and main- 

tained by the I/O system to indicate that a Type I 
request using the DCB is in progress. Any Type I 
request using a DCB that is made when the DCB is 
busy will result in an error. 

PACK is the indicator specifying packed binary for- 

mat on 7-track magnetic tape when BIN mode is 
also specified (1 indicates packed; indicates un- 
packed). PACK may be set using the 1 ASSIGN 
control command. This indicator is also set to 
value 1 when a DCB is opened and that DCB is as- 
signed to an operational label, which in turn is 
assigned to a 7-track magnetic tape. 

VFC is the vertical format indicator (0 indicates no 

format control; 1 indicates format control) specify- 
ing whether or not the first character of an output 
record is to be used to control vertical positioning 
for output to a line printer or keyboard/printer. 
Under format control, the line printer is given a 
"print with format" order. The keyboard/printer 
performs a preliminary new line (regardless of the 
format character) and outputs the record beginning 



1 2 TYi 5 6 7T3 9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27126 29 30 31 



See Chapter 3, XDS Sigma Card Readers (Models 7120/ 
7122/7140) Reference Manual, Publication No. 90 09 70. 



DCB Creation 33 



with the second byte. On all other devices, the 
first byte is output as data. VFC has no effect on 
other I/O operations. This indicator issetatDCB 
creation by ! ASSIGN control command or through 
the Device Mode system call. The format control 
codes are itemized in Table 11. 

BTD is the byte displacement specifying at which 

byte (0-3) in a buffer the data begins. 

ASN is the assignment type indicator (0 means null; 

1 means RAD file; 2 means not used; 3 means de- 
vice or system operational label). 

Word 1 

NRT is the number of recovery tries to be allowed 
before outputting a device error message. This 
parameter is set at DCB creation or through an 
! ASSIGN control command. 

DEVF is an indicator specifying whether the device 

assignment (when ASN has value 3) in force is 
directly to a physical device or indirectly through 
an operational label (1 means direct; means in- 
direct) . This indicator may be set at DCB crea- 
tion or by an ! ASSIGN control command. See 
TYPE and DEV/OPLB/RFILE discussion below. 

L is an indicator specifying whether the assigned 

device is a line printer or keyboard/printer. The 
indicator is set by the system at OPEN time. 



TYPE is a field indicating the type of device that 

is directly assigned if ASN has value 3 and DEVF 
has value 1. 



Vali 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

13 



Device 

TY 

PR 

PP 

CR 

CP 

LP 

DC 

9T 

7T 

CP (Low Cost) 

LP (Low Cost) 

PL 



If ASN has value 1, TYPE specifies the area that 
contains the RAD file. 



Vali 




1 
2 

3 
4 
6 

20 



Area 

SP 

FP 

BP 

BT 

XA 

Dl 



DF 



Table 11. Line Printer Format Control Codes 



Code (hexa- 




decimal) 


Action 


CO, 40 


Space no additional lines. 


60, E0 


Inhibit space after printing. 


CI 


Space 1 additional line before 




printing. 


C2 


Space 2 additional lines before 




printing. 


C3 


Space 3 additional lines before 


. 


printing. 


CF 


Space 15 additional lines before 




printing. 


F0 


Skip to Channel (bottom of 




page) before printing. 


Fl 


Skip to Channel 1 (top of page) 




before printing. 


F2 


Skip to Channel 2 before printing. 


FF 


Skip to Channel 15 before 




printing. 



DEV/OPLB/RFILE 
1. 



contains one of three: 



The DCT index of the assigned device when the 
assignment is to a device (ASN equals 3 and DEVF 
equals 1), 

The operational label table index of the assigned 
operational label when the assignment is to an op- 
erational label (ASN equals 3 and DEVF equalsO). 
The index values for standard system operational 
labels are 



Label 

C 

OC 

LO 

LL 

DO 

CO 

BO 

CI 

SI 

BI 

SO 

PL 



Index Value 

1 
2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 



The user is responsible for determining the index 
values for his optional operational labels. These 
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values are a function of the order in which the 
optional operational labels are specified as Sys- 
tem Generation. 

The index value for the devices are also a func- 
tion of the order that the devices are specified at 
System Generation. The TYPE and DEV/OPLB/ 
RFILE values are set at DCB creation or through 
! ASSIGN control commands. 

3. When a DCB is assigned to a RAD file (ASN 

equals 1), this field contains the index to the RFT 
(RAD We Table). This value is set when the DCB 
is opened. The RFT entry is created at OPEN if 
an entry does not already exist for the file. 

Word 2 

TYC is an indicator showing the type of comple- 

tion for an I/O operation. TYC is set by the I/O 
system at the completion of each request that uses 
the DCB in a Type I mode (see discussion of Read 
and Write system calls below). 

The completion type codes are 



Code 
1 
2 
3 
5 
6 
7 



10 



Meaning 

Normal 

Lost Data 

Beginning of Tape 

End of Tape 

End of Data 

End of File 

Read Error 

Write Error 

Write Protection 
Violation 



BUF is the address of the user buffer for requests 

whose FPTs do not include a buffer address. The 
address is established at DCB creation by assembly 
language users who create their own DCBs. The 
parameter is not included in DCBs built by the 
Overlay Loader and is not set through ! ASSIGN 
control commands. 

Word 3 

RSZ is the default record size in bytes (1 5 RSZ 

2 32,767). The parameter is used as the byte count 
for Read/Write requests that do not include a byte 
count. RSZ may be set at DCB creation, either 
through a Device Mode system call or through an 
! ASSIGN control command. 

ERA is the address of the user's routine that handles 

errors associated with insufficient or conflicting 
information in the DCB or FPT. Zeros in this 
field are used to indicate that no user error routine 



exists, (see discussion of error and abnormal returns 
below). This address can be established at DCB 
creation, but is more typically set through an 
OPEN system call. 

Word 4 

ARS is the actual record size in bytes. The param- 

eter is set by the I/O system when a request is 
completed. It is set in the DCB for Type I re- 
quests only. 

ABA is the address of the user's routine that handles 

abnormal conditions associated with insufficient or 
conflicting information in the DCB or FPT. Zeros 
are used to indicate that no user abnormal routine 
exists (see discussion of error and abnormal returns 
below). This address can be established at crea- 
tion time or set through an OPEN system call. 

If the TTL field in word has a value of 5, word 4 termi- 
nates the DCB. 

If the TTL field has a value of 7 or 90, and the DCB is as- 
signed directly to a RAD file, words 5 and 6 have the fol- 
lowing format: 

word 5 



CI 



C2 



1 2 3 F 4 5 6 7 I a 9 10 111 12 13 14 15 P 16 17 18 19(20 21 22 23 



C3 



C4 



24 25 26 27 1 28 29 30 3 



word 6 












C5 


C6 


C7 


C8 


1 2 3 t 4 . 


6 7 


8 9 1C 111 12 13 U 15 


16 17 16 19 !20 2 


22 21 


24 25 26 27 ! 2B 29 30 31 



where the C- are the EBCDIC characters defining the RAD 
file name when the assignment is to a RAD file (ASN 
equals 1). The file name is left-justified and filled with 
trailing blanks. The name can be placed in the DCB at 
creation time or through ! ASSIGN control command. 
Note that DCBs assigned to RAD files at creation time, with 
the file names included, are not compatible with Batch Pro- 
cessing Monitor DCBs. Such DCBs can be used under BPM 
only if the assignment is reestablished through use of the 
! ASSIGN control command. If the words 5 and 6 are all 
zero and ASN specifies assignment to a RAD file, theentire 
area specified in TYPE is taken as the file. 

ERROR AND ABNORMAL CONDITIONS 

Certain error codes are returned to the user's error or ab- 
normal return routines upon occurrence of various conditions. 
At entry to these routines, the error code is contained in 
byte of register 10, the DCB address is contained in the 
address field (low-order 17 bits) of register 10, and the 
address of the location following the CAL1 is contained 
in register 8. 

Foreground users must provide error and abnormal returns on 
all I/O requests with wait and on all CHECK requests. If 
background users omit the error and abnormal addresses, the 
system will take action as detailed below. The error codes 
are defined in Table 12. 



Error and Abnormal Conditions 
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Table 12. Monitor Errors and Abnormal Returns 



Table 12. Monitor Error and Abnormal Returns (cont.) 



I/O 


Code 






(Hexadecimal) 






D f 


F ft 




C 


P 






B 


T 


Meaning of I/O Codes 


01 


X 




Abnormal Conditions (Continue) 


A DCB has been opened with in- 








correct parameters. 


03 


X 




The assigned RAD file does not exist 
or the assigned device is down. 


05 




X 


An end-of-data has been encoun- 
tered (i.e., an EOD has been read). 


06 




X 


An end-of-file has been encoun- 
tered (i.e., a control command has 
been read on the C device). 


07 




X 


The buffer specified is smaller than 
the data read. 


0A 


X 




An attempt has been made to close 
a DCB that is already closed. 


1C 




X 


The end-of-tape has been 
encountered. 


ID 




X 


The beginning-of-tape has been 
encountered. 


2E 


X 




An attempt has been made to open 
a DCB that is already open. 


30 




X 


The request resulted in a condition 
which the operator can correct. The 
proper message has been output on 
OC.™ 








Error Conditions (Abort, with post- 


40 


X 




mortem dump if specified) 


A request has been made to read 








an output device. 


41 




X 


An irrecoverable read error has 
occurred. 


42 




X 


A RAD write protection violation 
has occurred. 


44 


X 




A request has been made to write 
on an input device. 


45 




X 


An irrecoverable write error has 
occurred. 


46 


X 




The DCB contains insufficient infor- 
mation to open a closed DCB on a 
read operation. 



I/O Code 




(Hexadecimal) 






D f 


F» 




C 


P 






B 


T 


Meaning of I/O Codes 








Error Conditions (Abort, with post- 


47 


X 




mortem dump if specified) 


The DCB contains insufficient infor- 








mation to open a closed DCB on a 








write operation. 


48 


X 




A nonreal-time request was made 
on a busy DCB. 


4A 


X 




The user buffer address is not valid 
or byte count is zero. 


54 


X 




More than one attempt has been 
made to read a control message from 
theCdevice, through the same DCB. 


55 


X 




The DCB cannot be opened because 
the RFT is full, the RAD is down, or 
no buffer could be found for the 
directory search. 


58 


X 




A foreground request was made to 
the C device. 


59 


X 




DCB has changed since being OPE Ned. 


60 


X 




Input request on a shared device 
or file. 


Returns due to in 


sufficient information (error or abnormal 


address in DCB is 


honored). 


Returns due to d 


evice failure or abnormality (error or 


abnormal address 


'n FPT is honored). 


All background 


requests (even those specifying ab- 


normal returns) w 


II be held until the operator corrects 


the condition. Tl 


lis condition is never returned to the 


background. 





1/0 SYSTEM CALLS 

OPEN A FILE 

OPEN The OPEN system call opens the data file if it is 

not already open. If the addressed DCB is assigned to a de- 
vice (directly or through an operational label), a count is 
kept of the number of open DCBs assigned to the device. 

If the DCB isassigned toaRAD file, an entry is built in the 
RFT (RAD File Table) if one does not already exist, and the 
indexof the entry is placed in the DEV/OPLB/RFILE field 
of the DCB. A count of open DCBs assigned to the RAD 
file is also maintained. The user may specify a buffer 
to be used in the RAD File directory search but this is 
not mandatory. If such a buffer is not given, the OPEN 
function will use available blocking buffers. 
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At OPEN, the error and abnormal addresses in the DCB may 
be set or changed. The OPEN function causes the speci- 
fied DCB's file-open indicator (OPEN) to be set to 1. 

If the specified DCB isassigned to an operational label and 
the operational label in turn, is assigned to a 71 device, 
PACK and BIN are set to 1 . 

If a DCB is already open (OPEN = 1) for device-assigned 
DCBs when the OPEN function is called, an abnormal con- 
dition is signaled (see Table l^j. The device indicator 
(DEV/OPLB/kFILE) of the DCB is checked for validity. If 
it references a valid operational label or physical device, 
the DCB is marked open; if the device indicator is invalid, 
the DCB is not marked open and an abnormal condition is 
signaled (see below for the OPEN call format). 

For DCBs assigned (directly or through op labels) to line 
printers or keyboard/printers, the L indicator in the DCB 
is set to 1 . 

CLOSE A FILE 

CLOSE The CLOSE function closes a DCB by setting the 

DCB open indicator (OPEN) to 0, which may result in closing 
the assigned data file on a device or RAD file, the CLOSE 
function decrements the "open DCB count" in the proper 
DCT or RFT entry, and if the count becomes zero, the data 
file is closed. 

If the data file is to be closed and is a RAD file opened for 
output, the directory entry for the RAD file is updated with 
the information from the RFT entry and the entry is deleted 
from the RFT table. 

If the data file is to be closed and is a RAD file opened for 
input only, the entry is deleted from the RFT table. 

Closing other types of data files requires no action. 



optional 



,t 





Abnormal address 


u 




u 


1 2 3 t 4 5 


6 7 1 B 9 10 111 1 


2 13 14 


15l 16 17 


6 WI20 21 22 23! 24 25 26 27128 29 30 31 



optional 









Blocking buffer address 


1 2 3 1 4 5 


6 7 1 B 9 10 III 12 13 14 


15ll6 t? IB 19I20 21 22 23l24 25 26 27 1 28 2? 30 31 



Word 

Code is X'14' for OPEN, X'15' for CLOSE. 

DCB address is the address of the associated DCB 

Word 1 

P. is the error address parameter presence indicator 

(0 means absent; 1 means present). 

P„ is the abnormal address parameter presence in- 

dicator (0 means absent; 1 means present). 

P is the buffer address parameter presence indi- 

cator (0 means ^M ' eja i'it; 1 means nhtant). 



Word Options 



bW-.'-'V 



)»('-5 t 



Error address is the address of the entry to the user's 

routine that will handle error conditions. 

Abnormal address is the address of the entry to the 

user's routine that will handle abnormal conditions. 

Blocking Buffer address is the address of a 257-word 

buffer to be used for file directory search if the 
DCB is being opened to a RAD file. 



OPEN AND CLOSE SYSTEM CALL FORMAT 
OPEN and CLOSE system calls have the format 

CAL1, 1 address 
where address points to word of the FPT shown below, 
word 



Code 



rmrrT 



word 1 











DCB address 



8 9 10 111 12 13 14 15I 16 17 \S 19I2O 21 22 23! 24 25 26 27128 29 30 31 







1 2 3 I 4 5 6 7l8 9 tO 11112 13 \4 15 T 16 17 18 19 T 20 21 "22 "23 1 24 25 26 27126 29 30 31 



CHECK I/O COMPLETION 

CHECK The CHECK function tests the type of comple- 

tion of an I/O operation initiated by a no-wait request. 
The user specifies addresses, which are entries to his routines, 
that handle error and abnormal conditions. At entry, regis- 
ter 10 contains the error or abnormal code as detailed in 
Table 12. Background users may take advantage of the | 

standard system handling of the error and abnormal address 
in the FPT . The action taken by the system in this case is 
also detailed in Table 12. Foreground users must provide I 
both error and abnormal addresses when checking (CHECK, 
no-wait) requests. 

Users may specify a CHECK with no-wait by including a 
busy address in the FPT. This address is taken (with the 
address of the location following the CHECK CAL1 in 



optional 



0- 



Error address 



1 2 314 5 Z 7T8 9 10 11112 13 U 15116 17 IB 19120 21 22 23124 25 26 27128 29 30 31 



In all FPTs for I/O functions where an optional parameter 

is not used, the parameter word must be omitted from the 

FPT and the corresponding presence indicator (P ) set to 0. 

n 
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register 8), if the CHECKed operation is not complete. If 
no busy address is included in FPT, the CHECK function 
will wait for completion before taking the appropriate action. 

The CHECK function (through its own FPT) addressesa DCB 
or an FPT, depending upon whether the request was Type I 
or Type II. The FPT associated with a request is addressed 
if the request was Type II and the completion parameters 
were posted in the FPT by the I/O system. A DCB is ad- 
dressed if the request was Type I and the completion param- 
eters were posted in the DCB. 

The CHECK function call is of the form 

CAL1, 1 address 

where address points to word of the FPT shown below. 

word 



Code 







DCB or FPT address 



i 2 Tfl 5 6 7(3 9 10 llll2 13 14 15I 16 17 18 I9I2O 21 22 23I24 25 26 27 1 2S 29 30 31 

word 1 



P , P 2 P 3 O-'.oO 



-0 



12 3(4 5~ 6 7 I B 9 10 ill 12 13 14 15 1 16 17 18 T9 1 20 21 22 23 1 24 25 26 27 1 29 29 30 3 

optional 



o 



•0 



Error address 



1 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 I5I16 17 18 19 1 2C 21 22 23^4 25 26 27 1 28 29 30 3 

optional 



0- 



> I 4 5 6 7 I 8 9 'C 111 12 



Abnormal address 



3 14 15! 16 17 18 191 20 2! 22 23124 25 26 27! 29 29 30 3 



optional 



0- 



-0 



Busy address 



tl 9 1C 11 I 12 13 14 15! 16 17 16 19I2O 21 22 23 1 2-4 25 26 27I2B 29 30 3 



where 



Word 

Code is X'29' for the CHECK function. 

DCB or FPT address is the address of the DCB or 

FPT where the completion status is posted. P-iq 
determines whether this field contains a DCB or 
FPT address. 

Word 1 



P is the error address parameter presence indicator 

(1 means present; means absent). 

P is the abnormal address parameter presence in- 

dicator (1 means present; means absent). 

P is the busy address parameter presence indica- 

tor (1 means present; means absent). 

P . is a code to determine whether a DCB or FPT 

is addressed (0 means DCB; 1 means FPT). 



Word Options 

Error address is the address of the entry to the user's 

routine that will handle error conditions. 

Abnormal address is the address of the entry to the 

user's routine that will handle abnormal conditions. 

Busy address is the address of the entry to the user's 

routine that will handle the "request busy" conditions. 



READ A DATA RECORD 

READ The READ function causes the I/O system to read 

a data record into a user buffer from the device or RAD file 
specified by the DCB. 

If the addressed DCB is closed when the READ request is 
| made, an implicit OPEN will be performed on the DCB. 

READ requests may specify either a "wait for completion" 
or an "immediate return" condition. Foreground requests 
with wait must include error and abnormal returns in the 
FPT. Background requests can omit these addresses and have 
the system handle error and abnormal conditions. For re- 
quests with no-wait, such addresses in the READ FPT would 
be superfluous, since the user must perform a CHECK to 
test for error or abnormal conditions resulting from the request. 

Should the input record be physically longer than the speci- 
fied buffer length, data is lost and the user is notified 
through an abnormal return with code 07. 

Should the input record be physically shorter than thespeci- 
fied buffer length, the buffer is not filled and the acutal rec- 
ord length is posted in the FPT or DCB. 

Input from the card reader is performed either in automatic 
or binary mode. If the card reader is not the C device, the 
input mode is determined by the BIN flag in the DCB. The 
C device is always read in automatic mode. Foreground 
prog rgnis may not read the C_dfcvis«&.as-ihis would djsrurjt 
thejxickg round job stream. 

Input from the C device results in all control commands 
(I in column 1) being intercepted by the I/O system. Any 
control command other than ! EOD causes an abnormal re- 
turn with a code of 06 in register 10. The input record is 
kept in the RBM control command buffer. If an attempt is 
made to read this same device again, an error return with 
code 54 is given (see Table 12). 

An ! EOD record encountered from a card reader or paper 
tape reader on a READ request results in an abnormal return 
with code 05. 

For random access input from RAD files, the user includes 
a key in the FPT. All READ requests without a key 
parameter are assumed to be sequential access requests 
and result in the next record in order being input into 
the user buffer. For sequential input from blocked files, a 
request without a key parameter may not result in an 
actual RAD access. 
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For sequential access input from compressed files, the I/O 
system decompresses the record in transmitting it to the 
user buffer. 

Type II READ requests must include in their FPTs a comple- 
tion status parameter in which the I/O system will post the 
type of completion code and the actual byte count. 

A Type I READ request that finds the DCB busy with a pre- 
vious Type I request results in an error condition (error 
code 48). 



WRITE A DATA RECORD 

WRITE The WRITE function causes the I/O system to 

write a data record from a user buffer to the device or RAD 
file specified by the DCB. 

WRITE requests may specify ' |wait " or " no-wa it". As with 
READ requests, WRITE requests specifying wait must include 
error and abnormal return addresses in the FPT. For requests 
with no-wait, such addresses in the FPT would be superfluous 
since the user must perform a CHECK to test for error and 
abnormal conditions resulting from the request. 

For random access output to RAD files, the key address pa- 
r ameter isTncTud ecT in the FPT. ATI WRITE requests without 
a key address para meter present are assumed to be sequential 
acc ess reque sts. 

for output to compressed files, the I/O system compresses 
the record in transmitting it to the system blocking buffer. 

Type II Write requests must include a completion status pa- 
rameter word in their FPTs in which the I/O system will post 
the type of completion code and the actual byte count. 

A Type I request that finds the DCB busy with a previous 
Type I request results in an error condition (error code 48). 



optional 







1 2 3l 4 5 6 7 



optional 



1 2 3 14 5 6 7 



optional 



0- 



i 2 31 4 5 6 7 



optional 



0- 



1 2 3 14 5 6 7 



optional 



6 1 ' J SU 5 6 

optional 



I 



9 10 11! 12 13 14 15 



9 10 111 12 13 14 15 



9 10 111 12 13 14 15 



9 10 111 12 13 14 15 



9 10 11 1 12 13 14 15 



1 2 3 t 4 5 6 7 I 8 9 10 II I 12 13 14 15 

optional (Completion Status) 



Completion 
zgde I 

3 I 4 5 6 Tt 



1 2 3 14 5 6 7iB 9 10 111 12 13 H 15 



optional 



0- 



■o 



Abnormal address 



16 17 18 1?r2Q 21 22 23 1 24 25 26 27l28 29 30 3l' 



Buffer address 



161713191 20 21 22 23124 25 26 27126 29 30 31 



Byte count 



16 17 18 19l 20 21 22 23 1 24 25 26 27126 29 30 3! 



BTD 



16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



\ey 



16 17 16 19120 21 22 23124 25 26 27128 29 30 31 



End-action address/no. 



16 17 16 19120 21 22 231 24 25 26 27128 29 30 31 



Actual byte count 



16 17 18 19120 21 22 23T24 25 26 27128 29 30 31 



Blocking buffer address 



i 2 3 14 5 6 718 9 10 llll2 13 14 I5I16 17 18 19I 20 21 22 23^4 25 26 27 1 28 29 30 31 

where 

Word 

Code is X' 10' for READ and X' 1 1 ' for WRITE. 

DCB address is the address of the associated DCB. 

Word 1 



\ 



READ AND WRITE FUNCTION CALL FORMAT 

Calls for these functions are of the form 

CAL1, 1 address 
where address points to word of the FPT shown below, 
word 



Code 



1 2 3 I 4 5 6 7 







■0 



DCB address 



9 10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 27128 29 30 31 



word 


1 
































p 
i 


p 

2 


P 
3 


P 

4 





P 

6 





P 

8 


P 

9 


P 

10 


P 

11 


— 





F 
1 


F 

2 


F 
3 


F 

* 


F 
5 








1 


2 


3 


4 


5 


«6 


7 


8 


9 


10 


111 12 13 1 


4 15(16 17 18 19^20 21 22 23^4 25 


26 


27 


28 


29 


30 


31 



optional 



i 2 3 !< 



iddr 



error address 



t~8 9 10 11 I 12 13 14 15 1 16 17 16 19 f 20 21 22 23 1 24 



P is the error address parameter presence indicator 



(0 means absent; 1 means present). 



P„ is the abnormal address parameter presence indi- 

cator (0 means absent; 1 means present). 

P is the buffer address parameter presence indicator 

(0 means absent; 1 means present). 

P is the byte count parameter presence indicator 

(0 means absent; 1 means present). 

P is the byte displacement parameter presence in- 

dicator (0 means absent; 1 means present). 



P_ is the key parameter presence indicator (0 means 

absent; 1 means present). 



P_ is the end-action parameter presence indicator 



25 26 27 1 28 29 30 31 



(0 means absent; 1 means present). 
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P.. is the request type indicator (1 means Type II; 

means Type I) and indicates the presence of the 
Completion Status Parameter. 



11 



is the blocking buffer address parameter pres- 
ence indicator (0 means absent; 1 means present). 

is the direction indicator for READ (0 means for- 
ward; 1 means reverse). This indicator has effect 
on Magnetic Tape Read/Write operations only. 

is the wait indicator (0 means no-watt; 1 means 
wait for I/O completion), 

is the RAD Check-Write indicator (1 means write 
on a RAD will be performed by a Write, Check- 
Write; means a normal write will be done). 

is the paper tape direct Read/Write indicator 
(1 means binary paper tape Read/Write operations 
are performed ignoring the standard paper tape bi- 
nary record control information; means standard 
binary format is assumed). 

is the paper tape Read immediate indicator. If 
F j is 1 and F_ is 1 for a Paper Tape Read, the read 
is performed without ignoring leading blank frames. 
If F4 is 1 and Fc is 0, paper tape reads are per- 
formed ignoring leading blank frames. This indi- 
cator is only significant for binary paper tape read 
requests with F , = 1 . 



Word Options 

Error address is the address of the entry to the user 

routine that will handle error conditions for re- 
quests specifying wait. 

Abnormal address is the address of the entry to the 

user routine that will handle abnormal conditions 
for requests specifying wait. 

Buffer address is the word address of the user buffer 

to be used in the I/O operation. Data is written 
from or read into this buffer. If this parameter is 
omitted, the buffer address is taken from the DCB 
(BUF). 

Byte count is the size in bytes of the data record. 

If this parameter is omitted, the record size is 
taken from the DCB (RSZ parameter). 

BTD is the byte displacement (0-3) from the word 

boundary of the beginning of the data record. If 
this parameter is omitted and the Buffer address 
parameter is included in the FPT, value is 
assumed for BTD. If both parameters are omittea 
from the FPT, the values of the DCB are used 
for both. 



I, End-action address/no. I indicates the contents 

of the End-action address number field. End-action 
is allowed only for foreground;- 

Value indicates an end-action address. ' 

Value 1 indicates an interrupt number. % . <i 

Value 2 indicates an interrupt operational label. 

End-action is taken only in the case of an actual 
I/Ooperation involving data transfer too peripheral. 

Completion status is the word wherein the I/O sys- 

tem posts the completion parameters for the request 
(presence of this parameter indicates that the re- 
quest is of Type II). The I/O system initializes the 
word to zero before starting the operation. At com- 
pletion of the request (cleanup), the actual byte 
count and the completion code are posted in the 
word. CHECK may be used to test the parameters. 

Blocking buffer address is the address of a 257-word 

buffer to be used for file directory search if the 
DCB is being opened to a RAD file. 



REWIND, UNLOAD, AND WRITE EOF FUNCTIONS 

REW The Rewind causes a data file to be positioned at 

its beginning if the file is on magnetic tape or a RAD file. 
Rewind of a file on magnetic tape is accomplished by causing 
the tape drive to rewind to beginning of tape. Rewind of a 
RAD file is accomplished by setting the file position param- 
eter in the RAD File Table (RFT) so that the next sequential 
access request on the file results in the first record being ac- 
cessed. A Rewind request for a data file on any other device 
results in no action being taken. 

UNLOAD The Unload request results in the same action as 

Rewind except that magnetic tapes are rewound "off-line". 
When the rewind is concluded, the user must give an 
ATTENTION interrupt before the device can be used again. 
Failure to do so causes the device to timeout, and the operator 
must respond with a key-in before the device can be used again. 

WE0F Write End-of-File causes an EOF to be written 

if the addressed DCB is assigned to a magnetic tape unit. If 
the DCB is assigned to a Paper Tape Punch, an ! EOD rec- 
ord is output. If the DCB is assigned to a RAD file, an im- 
plicit EOF is written. If the DCB is assigned to any other 
type of device, no action is taken. 

Rewind (REW), Unload (UNLOAD) and Write End-of-File 
(WE OF) calls are of the form 

CAL1, 1 address 

where address points to word of the FPT below. 
word 



Code 


n 




o 


DCB address 


1 


2 3 U 5 6 7 


& 9 


10 11 1 12 1 


3 14 


15 1 16 17 1 


8 19120 21 22 23124 25 26 27 1 28 29 30 31 



Key is the number of the granule in a RAD file to 

be accessed directly. Presence of this parameter 
implies direct access to a RAD file. 



Code is X'OV for REWIND, X'02' for WEOF, and 

X'03' for UNLOAD. 

DCB address is the address of the associated DCB. 
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FILE AND RECORD POSITIONING FUNCTIONS 

These functions are used to alter position within a data file 
on magnetic tape or RAD. 

PFIL, PREC A Position File (PFIL) call causes a magnetic 
tape to be positioned at the beginning or end of the current 
file if backward or forward direction, respectively, is spe- 
cified and no skip is requested. If skip is requested, the 
tape is positioned as above except that the file mark is 
skipped over in the specified direction. Position File for- 
ward without skip positions the tape at the end of the cur- 
rent file (before the EOF). With skip, Position File forward 
positions the tape at the beginning of the next file. 

Position File causes a "rewind" of RAD files when "back- 
ward" is specified, and positioning after the last record in 
a RAD file when "forward" is specified. 

Position Record (PREC) causes a tape or RAD file to be 
moved n records in the specified direction. 

Position File and Position Record are ignored when the data 
files are on devices other than magnetic tape or RAD file. 

File and Record positioning calls are of the form 

CAL1, 1 address 
where address points to word of the FPT shown below. 
word 



Code 







DCB address 



I 2 314 5 6 7 78 9 10 II M2 13 14 15l 16 17 18 1?1 20 21 22 23T24 25 26 27128 29 30 3 



It? 



word 1 
















r 
i 


p 

2 


o- 










s 

K 
1 

P 


D 
1 
R 


— 








u 





1 


2 3 


1 4 5 6 


7 1 8 9 10 111 1 


2 13 14 1 


51 16 17 18 19! 20 21 22 23 1 24 25 


26 


27 


28 29 30 31 



optional 



N 



1 2 3T4 5 6 7 I 8 9 10 llll2 13 14 !5ll6 17 18 19120 21 22 23124 25 26 27 1 28 29 30 31 



optional 



0- 











Abnormal address 


1 


2 3 


4 5 


7 1 6 


9 10 111 12 13 14 


15116 17 18 19 1 20 21 22 23^24 25 26 27 1 28 29 30 31 



Word 

Code is X' 1C for Position File, and X'lD' for 

Position Record 

DCB address is the address of the associated 

DCB. 

Word 1 

P. is the record count (N) address parameter pres- 

ence indicator (0 means absent; 1 means present). 
P] must be for Position File. 



P_ is the abnormal address parameter presence in- 

dicator (0 means absent; 1 means present). P„ 
must be for Position File. 



SKIP indicates whether the EOF is to be skipped 

over in positioning magnetic tape. This param- 
eter has significance only for Position File and on 
magnetic tape (0 means no skip; 1 means skip). 

DIR Is the direction indicator (0 means forward 

positioning; 1 means backward positioning). 

Word Options 

N is the number of records to position. 

Abnormal address is the address of the entry to the 

user's routine that will handle abnormal conditions 
(EOT, BOT, etc.), for this I/O operation (Posi- 
tion Record only). 



PRINT AND TYPE FUNCTIONS 

PRINT, TYPE The PRINT function causes the Monitor to 

list the user's message on the listing log device (operational 
label LL). The TYPE function causes the Monitor to list the 
user's message on the operator console device (operational 
label OC). These functions are reentrant and available to 
foreground programs. Error and abnormal conditions result- 
ing from these functions are ignored. 

Print and Type may be performed without a wait for com- 
pletion, but the user is warned that changing the output 
buffer after return from such a request may result in the 
output message being modified. 

Calls for these functions are of the form 

CAL1, 2 address 
where address points to word of the FPT shown below. 

word 



Code 



8 t 2 3li 



word 1 



0- 



-0 



9 10 111 12 13 H 15 1 16 17 19 19Im 21 22 23 1 24 25 26 27l28 29 30 3 



1 2 3 14 5 6 7 18 9 10 11 1 12 13 14 15116 17 IB 19120 21 22 23 1 24 25 26 27 



— 



2B 29 30 31 



word 2 



Message address 



!3"t2 



7f2 



1 2 3 I 4 5 6 7 I 8 9 10 11 I 12 13 14 151 16 17 18 19120 21 22 23124 25 26 27128 29 30 3 

where 

Code is X'GT for Print and X'02' for Type. 



P. is the message address parameter presence indi- 

cator (P -I = 1) . P] is assumed to be a 1. 
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F is the waif indicator (0 means no-wait; 1 means 

wait for I/O completion). 

Message address is the address of the first word of 

the message. 

Note that the first byte of the first word of the message must 
specify the number of characters to be listed, up to a maxi- 
mum of 132 characters for a line printer and 85 characters 
for a typewriter. 



DEVICE/FILE MODE AND FORMAT CONTROL FUNCTIONS 

The DEVICE/FILE Mode function is used to set the following 
parameters: 

Modes (MOD, PACK) in the addressed DCB. 

Record Size (RSZ) in the addressed DCB and in the 

RFT entry if the DCB is assigned to an output file. 

File Organization in the assigned file's RFT entry 

if the DCB is assigned to an output file. 

Granule Size in the assigned file's RFT entry if the 

DCB is assigned to an output file. 

The parameters set in the RFT entries for permanent files 
will be written into the RAD file directory entry for the 
file when the file is closed. Thus, this function defines 
the parameters for permanent RAD files. 

The Device Vertical Format function causes the Moniforto 
set the vertical-format-control indicator of the specified 
DCB to 1 or to 0. 

Calls for these functions are of the form 

CAL1, 1 address 

where address points to word of the FPT below. 

word 



optional 



Code 



-0 



DCB address 



1 2 3 I 4 5 6 7 I 6 9 10 11 1 12 13 "14 13 1 16 17 18 l?l 20 21 22 23 1 M 25 26 27 1 28 29 30 31 



word 


1 (for Device/File Mode Function) 










p 

i 


p 

2 


P 
3 


n n 


F 3 





F , 


— 







l 


2 


3 1 4 5 6 7 1 B 9 10 11 1 12 13 14 15 1 16 17 18 19 1 20 21 22 23124 


25 


26 


27 


28 29 30 3) 



word 1 (for Device Vertical format Function) 



o 










n 


V 
F 
C 







1 


2 3 14 


6 


7 


e 


10 11112 13 14 15116 17 18 19120 21 22 23124 25 26 


27 


26 29 30 31 



word 2 (with Device/File Mode Function only) 



RSZ 



I 2 3 ! 4 5 6 7 I B 9 10 11112 13 14 15! 16 17 IB 19120 21 22 23 1 24 25 26 27I2B 29 30 3 



n 


ORG 


u u 


1 2 


3 14 


6 


1 8 


V 


10 111 12 13 14 15! 16 17 18 


19120 21 22 23124 25 26 27128 29 


30 31 



optional 







GSZ 



i 2 3 I 4 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 18 19 1 20 21 22 23 I 24 25 26 27 1 28 29 30 3 

where 

Word 

Code is X'22' for Device/File Mode, X'05' for 

Device Vertical Format. 

DCB address is the address of the associated DCB. 



Word 1 (option 1) 

P 1 is the record size parameter presence indicator 

(0 means absent; 1 means present). 

P is the file organization parameter presence indi- 

cator (0 means absent; 1 means present). 

P is the granule size parameter presence indicator 

(0 means absent; 1 means present). 

F 1 1 means BIN; means BCD. 

F» 1 means unpacked format; means packed. 

Word 1 (option 2) 

VFC is the vertical-format-control specification 

(0 means no format control; 1 means format control). 

Word 2 

RSZ is the maximum record size specification, in 

bytes. 

Word Options 

ORG is the file organization type: 

00 for unblocked 

01 for blocked 

1 for compress 
GSZ is the granule size in bytes. 

ST0PI0, STARTI0 These calls are of the form 

CAL1, 5 address 

where address points to word of the FPT shown below, 
word 



Code 



0-0 



DOD 



DCB/OP/DEVICE 



Two alternative forms of word 1 are shown. 



7 1 5 3 14 5 6 718 9 10 11 I 12 13 14 lsll6 17 18 '9 1 20 21 22 23 1 24 25 26 2?!2B 29 30 3' 

where 

Code = X'10' for STOP all system I/O 

= X'll' for START all system I/O 
= X'OE' for STOP background I/O 
= X'OF" for START Background I/O 
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HIO =0fornoHIO 
= 1 for HIO 

IOP = reserve device and controller 

= 1 reserve entire IOP 

DOD =00 DCB address is given 

= 01 operational label index is given 
= 10 device index is given 

DCB/OP/DEVICE contains the DCB address, oper- 

ational label index, or device index as specified. 

I0EX IOEX cal Is are of the form 

CAL1, 5 address 

where address points to word of the FPT shown below, 
word 



Code 



DOD 



DCB/OP/DEVICE 



1 2 314 5 6 718 9 10 11112 13 14 15116 17 IB 19120 21 22 23124 25 26 27I2B 29 30 31 



word 1 



i 2 314 5 6 7 

optional 



i 2 3 14 5 6 7 



optional 



I 







8 9 10 lit 12 13 14 15 ! 16 17 18 wlffi 21 22 23 1 2< 25 26 2l\tt 29 30 3 



-0 



SIO address 



8 9 10 111 12 13 14 isl 16 17 18 Iflt 20 21 22 23^ 24 25 26 27 1 28 29 30 31 



End-acHon address no. 



9T2 



iiti 



Ttl 



i 2 3 I 4 5 6 7T8 9 10 11 I 12 13 14 15l 16 17 16 191 20 21 22 23! 24 25 26 27 1 28 29 30 31 

where 

Word 

Code =X'12' forSIO 
= X'13' forTlO 
= X'14 I for TDV 
= X'15' for HIO 

DOD = 00 if DCB address is given 

= 01 if an operational label index is given 
= 10 if a device index is given 



DCB/OP/DEVICE contains the DCB address, oper- | 

ational label index, or device index as specified 
by DOD. 



Word 1 



P. is the SIO address parameter presence bit (0 

means absent; 1 means present). 

P. is the end-action parameter presence bit (0 

means absent; 1 means present). 



Word Options 

SIO address is the address of the IOP command 

doubleword 

I, End-action address no. I indicates the contents 

of the End-action address number field. 

Value indicates end-action address. 
Value 1 indicates interrupt number. 
Value 2 indicates interrupt label. 

The TIO, TDV, and HIO operations are performed immedi- 
ately and the condition codes and status are returned as 
shown in Table 13. I 

The command pairs for an SIO operation are not checked for 
validity. The flags in the command pairs may be set ac- 
cording to the needs of the user. The SIO is issued whether 
or not the device is busy or in manual mode, and the status 
is returned to the caller. It is the user's responsibility to 
sense for the manual mode before and after the SIO request 
and then inform the operator with a suitable message. 



When I/O interrupts occur as a result of IOEX (SIO only), 
end-action is initiated as requested in the FPT. The end- 
action is identical to that for READ/WRITE calls. 

Table 13 shows the status returned from the different IOEX 
functions. 



Table 13. IOEX Function Status Returns 



Operation 


Major Status 


Condition Codes 


Register 8 


Register 9 


ALL 


Device not preempted 


0001 








ALL 


No I/O address recognition 


1100 








SIO 


I/O address recognized 
and SIO accepted 


0000 


Current command 
address 


Status and byte count 




I/O address recognized 


0100 


Current command 


Status and byte count 




but SIO not accepted 










Device controller is 


1000 





- 




attached to "busy" 










selector IOP 
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Table 13. IOEX Function Status Returns (cont.) 



Operation 


Major Status 


Condition Codes 


Register 8 


Register 9 


TIO 


I/O address recognized 
and SIO is currently 
possible 


0000 


Last command 
address 


Status and byte count 




I/O address recognized 


0100 


Current command 


Status and byte count 




but SIO not possible 




address 






Device controller at- 


1000 










tached to "busy" selector 










IOP 








TDV 


I/O address recognized 


0000 


Current command 


Status and byte count 




I/O address recognized 


0100 


Current command 


Status and byte count 




and device dependent 




address 






condition present 










Device controller at- 


1000 










tached to "busy" 










selector IOP 








HIO 


I/O address recognized 
and device controller is 
not busy 


0000 


Current command 


Status and byte count 




I/O address recognized 


0100 


Current command 


Status and byte count 




but device controller "busy" 




address 
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5. USER PROGRAM SCHEDULING AND OPERATION 



SCHEDULING AND LOADING PROGRAMS 

The Overlay Loader links relocatable object modules to 
form an absolute load module representation of the program. 
The load module is created as a RAD file and consists of a 
header and an absolute core image of the various program 
segments. The load module header contains the program 
parameters used by the Root Loader for Loading the program 
root. 

LOADING AND RELEASING FOREGROUND PROGRAMS 

Loading and initializing of a foreground program root is per- 
formed by the Foreground Root Loader, and involves the fol- 
lowing steps: 

1. Opening the file containing the absolute load module. 

2. Building a Foreground Program Table entry that con- 
tains the program name, core memory to be used by 
the program (root and all segments), and the public 
libraries used by the program. The last two parameters 
are taken from the load module header. 

3. Testing for required core size availability. If some 
portion of required foreground memory is busy, a mes- 
sage is typed, the Foreground Program Table entry is 
purged, and an error return is given. If no busy fore- 
ground core is required but some portion of background 
is needed, the background is checkpointed and the 
core area marked as foreground. If the foreground 
memory is not busy or if the background has been check- 
pointed (if necessary), the load process 

• Loads the program root. 

• Sets the PCB pointer in X'4E' to point to the fore- 
ground user program PCB. 

• Transfers control to the start address, taken from 
the load module header, where the user program 
initializes itself (connects tasks, conditions inter- 
rupts, etc.). 

When initialization is completed, the user program performs 
an EXIT function call. The EXIT function will recognize 
that initialization of a foreground program has been com- 
pleted and will transfer control back to the RBM Control 
Task (the EXIT call does not cause an exit from the RBM 
Control Task). 

A foreground program root can be loaded by any of the 
following: 

! RUN control command 

! ROV control command 

RUN key-in 

RUN system call from a foreground task 



Since the root loading occurs at the level of the RBM Con- 
trol Task, foreground programs making RUN calls must give 
up the CPU (EXIT) before the load can be accomplished. 
Foreground tasks can request the triggering of an interrupt 
at conclusion of the root load and initialization. 

Release of foreground programs is also performed at the RBM 
Control Task priority through the following steps: 

1 . Disarming all interrupts connected to tasks within the 
program. The interrupts are specified in the INTTAB 
which is pointed to by a word in the program PCB. 

2. Closing any open DCBs within the program to cause 
I/O run-down in addition to closing data files. 

3. Purging the foreground program entry, which has the 
effect of marking the memory as not busy. 

4. Restarting the background if it has been checkpointed, 
and if release of this foreground program makes avail- 
able the memory needed for the background. 

Release of a foreground program occurs as a result of either 
an RLS key-in or RLS system call. 

LOADING AND EXECUTING BACKGROUND PROGRAMS 

The Background Root Loader loads background programs as 
specified by control commands in the background job stream 
at the Control Task priority level. 

The Background Root Loader will only load a background 
program root if the background memory area is large enough 
to contain the entire program (root and segments). Upon 
completion of the root load, control is transferred to a 
background program at its start address. The background 
program terminates execution with an EXIT or ABORT re- 
turn. After terminating a background program, RBM 
resumes processing the control commands from the back- 
ground job stream. 

TASK CONTROL BLOCK (TCB) 

A Task Control Block must be associated with each centrally 
connected real-time task, and is used by the system to save 
the context of the interrupted task upon occurrence of the 
given task's interrupt. The TCB is in the user program 
(assembly language users must allocate and define their 
TCBs in the source code of their program). The FORTRAN 
compiler generates implicitly the TCBs needed for a real- 
time FORTRAN program. 

TASK CONTROL BLOCK FORMAT 

The assembly language user must allocate a TCB in the 
source code for each centrally connected task in the pro- 
gram. Each TCB begins on a doubleword boundary and has 
a length of 26 words. 
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The RBM CONNECT function fills in the TCB. When com- 
pleted, a TCB has the following form: 







1 


Saved PSD 


2 
3 


Intermediate PSD 
skeleton key 


to transfer 


to TCB + 4 with 


4 


STM,0 






TCB+ 10 


5 


BAL,R1 






RBMSAVE 


6 


Indicators 




PCB address 


7 


Priority 


TCB address 


8 
9 


PSD to transfer to 
(mode, write key, 


task 
etc.) 


entry 


in proper state 


10 
25 


16 words for register saving 



where RBMSAVE is a system routine that 

1 . Exchanges the contents of X'4E', X'4F', and TCB +6,7. 

2. Sets appropriate indicators in TCB +6. 

3. Transfers to the task starting address by LPSD from 
TCB +8. 

Users must never alter any portion of a TCB. 

PROGRAM CONTROL BLOCK (PCB] 

The Program Control Block contains the program-associated 
parameters used by the RBM system to provide service func- 
tions for the program. Every program, background and 
foreground, contains a PCB that is allocated and constructed 
by the Overlay Loader. 

The Program Control Block defines the program Temp Stack 
to be used by a program. It also contains a pointer to a list 
of the DCBs associated with a program and a pointer to a 
list of interrupts connected to the tasks within a foreground 
program. This table of interrupts is filled by the CON- 
NECT routine as the various connect calls are made. 

Since the Temp Stack is associated with the program rather 
than individual tasks, different tasks within a program should 
not use these stacks for data communication. -Common stor- 
age can be used for communication between tasks or between 
occurrences of a given task. 

At all times during operation of RBM, location X'4E' and 
X'4F' contain pointers to the PCB and TCB, respectively. 
In addition, X'4F' contains the current priority level in 
byte 0. 



PCB FORMAT 

The PCB is built by the Overlay Loader from parameters 
specified on the IOLOAD control command. 



The PCB is of the form 
78 





14 15 



31 



1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

TSTACK 



TSTACK-1 



TSS 



No. of 
tasks 



Trap 
control 



OVLOAD 



INTTAB 



TRAPADD 



MSLADD 



Unused 



Unused 



Unused 



Unused 



DCBTAB 



Unused 



SSW 



User's Temp Stack 



14*15" 



TSS 



26 31 



TSTACK is the address of the current top of the 

user's temp stack. 

TSS indicatesthe size, in words, of the user's temp 
stack. 

OVLOAD is the address of the table used by the 

segment loader to manage the program overlays. 

No. of Tasks is the number of tasks in the program. 

This is also the number of entries in INTTAB. 

INTTAB is the address of the interrupt table associ- 
ated with the program. This table is maintained 
by the CONNECT function. The format of this 
table is shown below. 

Trap Control (Bits 1-7) specify how the various 

traps are to be handled. An explanation of these 
bits is given in the TRAP function description later 
in this chapter. 
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TRAPADD is the address of the user's routine which 
processes the various traps. 

MSLADD is the address of the M:SL DCB, which is 

used to load overlay segments. 

DCBTAB is the address of a table of names and 

addresses of all of the user's DCBs. This table has 
the form shown below. 

SSW contains the user's sense switch settings. 

Bit 26 contains the setting of switch 1, etc. The 
sense switches have no use in this initial release 
of RBM. 

DCBTAB Format 



DCTAB 






15 


16 


31 




Total no 
in table 


. entries 


c l 


C 2 


S 


C 4 


C 5 


C 6 


C 7 


C 8 


DCBLOCj 


S 


C 2 


C 3 


C 4 


S 


C 6 


C 7 


C 8 


DCBLOC 2 


etc. 
1 . 1 



1516 



31 



C -C 
1 78, 



indicates the EBCDIC name of the DCB, 



left-justified, with trailing blanks. 

DCBLOC is the absolute address of the first word 

location of the DCB. 



INTTAB Format 






15 


16 


31 


I 




INT 

n+ 1 


INT 

n 


; 


1NT4 


INT3 


INT2 


INT1 



1516 



31 



where I is the index value used to access the next available 
entry in the table < I £ 4N - 1 . N is the number of words 
allocated by the Loader for the table. The table is main- 
tained by the CONNECT system call. I has an initial value 
equal to the number of tasks. 



Each byte (interrupts 1 to n) represents the priority of the 
interrupt where a value of 1 represents the highest priority 
and corresponds to interrupt location X'50'. 

TEMP STACK 

The Temp Stack is a "push -down/pull -up" stack of memory 
locations that have been allocated by the Overlay Loader. 
It is required for Monitor functions and subroutines that use 
Temp Stack storage (i. e. , FORTRAN IV-H Library routines). 

The user can manipulate the Temp Stack by push/pull stack 
instructions (PSW, PLW, PSM, PLM, MSP) that indirectly ad- 
dress location '4E 1 , which contains the address of the exe- 
cuting program's PCB. The first doubleword of the Program 
Control Block is the stack pointer doubleword used in allo- 
cating (pushing) and releasing (pulling) blocks within the 
Temp Stack. 

The "push-down/pull-up" functions operate on a last-in, 
first -out basis, and these operations must be symmetrical in 
number and size. An attempt to push a block that is greater 
than the remaining stack space results in overflow. Sim- 
ilarly, an attempt to pull more out of the Temp Stack than 
had been previously pushed down would result in underflow. 
These conditions result in traps that may be handled by the 
user (see TRAP system call). 

The size of the Temp Stack must be equal to or greater than 
the total number of temp cells required by the maximum 
number of nested routines using temporary storage; (i.e., if 
a Monitor I/O routine needs 16 temp cells and it calls a 
routine that needs 19 cells, the total number of cells re- 
quired would be 35). The number of cells required for sys- 
tem CALs is 18 to 70; the FORTRAN IV-H Library subrou- 
tines require 148 temp cells for each task. 

Foreground tasks at different interrupt levels within the 
same program share the program's Temp Stack, and alloca- 
tion must be sufficient to accommodate the maximum number 
of tasks that could be enabled at one time. When an exe- 
cuting task exits, if must restore the temp stack pointer to 
its original condition. This is particularly important in a 
foreground program where a Temp Stack is allocated for each 
program and not each task. Thus, if several tasks in the 
same program share the program's Temp Stack, the house- 
keeping of the Temp Stack pointer (e.g., symmetrical 
pushes and pulls) must be meticulous. 

MASTER AND SLAVE MODES 

Foreground tasks can change their execution mode through 
MASTER and SLAVE system function calls. At entry to a 
task, the mode is set as specified by the function call that 
caused the connection. 

Note: Serious consequences can result from improper oper- 
ation in master mode. 

OVERLAY SEGMENT LOADING 

Overlay segments are loaded through a SEGLOAD system 
function call and the segment to be loaded is specified by 
number. 
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Both background and foreground programs may load overlay 
segments. The memory space necessary for a foreground 
program overlay is always available, since availability was 
verified when the root was loaded, and the total space used 
by the program and all its overlays was marked as busy by 
the Root Loader. Overlay segments are loaded at the prior- 
ity level of the requesting task. 

CHECKPOINT AND RESTART 



When the user program receives control in the trap routine, 
the following items are stored in sequence in a 19-word 
block of the program's Temp Stack, starting on a doubleword 
boundary: the PSD and the 16 registers saved when the trap 
occurred, and a word containing the trap location (right- 
justified). Register 1 points to word (first word of the PSD) 
in this block. If 19 words are not available in the Temp 
Stack, a background program is aborted; a foreground task 
is exited. 



Checkpoint and restart of the background are performed 
automatically by the system as foreground programs are 
loaded and released. Checkpoints are performed as neces- 
sary to load foreground programs. Restarts are performed as 
possible when foreground programs are released. Both func- 
tions are performed in the RBM Control Task. Checkpointing 
consists of 



1 



2. 



Writing the background program to a fixed area on the 
RAD (specified at SYSGEN) after the background pro- 
gram has stabilized (no background I/O request running). 

Marking the background memory as unused foreground 
to enable loading of foreground programs into that 
area. 



Restarting consists of 

1 . Reading the checkpointed background program from the 
RAD into memory if the required memory area is marked 
as unused foreground (no active foreground programs in 
the area), and marking this area as background. 

2. Restarting the background program at the point it was 
interrupted by the checkpoint request. 

TRAP HANDLING 

RBM provides standard processing of trap conditions. A user 
can either take advantage of the system processing or request 
that he himself handle certain trap conditions. Also, cer- 
tain traps can be ignored. System trap handling involves 
aborting (for background) or exiting (for foreground) the task 
that is active at the occurrence of a trap, with the follow- 
ing exceptions: 

1 . An unimplemented instruction trap occurrence will re- 
sult in the instruction being simulated if the simulation 
package is in the system. If simulation is impossible, 
the program will be aborted or exited. 

2. The user can mask out fixed-point arithmetic and deci- 
mal arithmetic traps either through system call (TRAP 
function) or at task connection time (CONNECT, ARM, 
DISARM functions). 

3. The user can mask out some floating-point trap occur- 
rences through use of the LCF and LCFI instruction. 

4. Any unmasked trap can be received by the active pro- 
gram. This is set up through the TRAP function call, 
wherein the user can specify the address of a routine to 
handle the various trap conditions. This address is kept 
on a per program basis as opposed to a per task basis. 



The address of the user trap routine and the control bit for 
each trap is kept in the PCB. 

User trap handling or system trap handling is also invoked if 
an invalid parameter exists in an FPT for a system call that 
is unable to post the error condition. In this case, an error 
code of X'50 1 will be posted in the last word of the user's 
Temp Stack if a user trap address is present in the PCB. 

Return from the user trap routine to the interrupted program 
is accomplished by the TRTN function, which restores the 
context from the Temp Stack and returns to the location fol- 
lowing the trapped instruction. 

RETURN FUNCTIONS 

RBM provides users with the following return functions: 

EXIT is used by background programs at the normal 

completion of a background program. EXIT is used 
by foreground programs when a centrally connected 
task has concluded the processing of an interrupt. 
An EXIT call from the foreground causes the system 
to restore the context of the interrupted program 
and return to the point of interrupt. 

ABORT is used by background programs to cause the 

system to abort the job containing the program. 
The system will abort the background program and 
type a message on the operator console (OC) that 
the job was aborted and give the address of the 
ABORT call unless an ! ATTEND command was 
present in the background job. The system will 
read and ignore all records from the C device until 
the next ! JOB card is encountered. If an ABORT 
call is made from a foreground program, an EXIT 
is performed. 



INTERRUPT CONTROL 

CONNECTING TASKS TO INTERRUPTS 

Interrupt connection may be accomplished through use of 
the CONNECT, ARM, or DISARM function calls. While 
these calls are usually made during foreground program 
initialization (performed at the Control Task priority level), 
this is not a requirement. A table of interrupts connected 
within a program is kept by the system. This table ispointed 
to by an entry in the program's PCB, and space for the table 
is allocated by the Overlay Loader in the user program. The 
table enables the foreground program release function to 
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disarm and disable all interrupts associated with a foreground 
program. In calling for connection the user may specify the 
mode (master, slave) and the interrupt inhibit conditions 
that are to exist at entry to the specified task. Two types 
of connections are available, direct and central: 

1. Direct connection results in immediate entry to the task 
upon occurrence of the interrupt. The task must ensure 
that the context is saved, as necessary, and restored 
upon exit. The task should set the priority field 
(byte 0) in location X'4F' to ensure that CPU time is 
not stolen for I/O cleanup for lower-priority tasks. If 
the task uses any RBM services, locations X'4E' and 
X'4F' must be properly set. 

2. Central connection results in entry to the task after the 
interrupted task context has been saved. The CONNECT 
function constructs the TCB so that the context save 
will occur. Exit from a centrally connected task is by 
EXIT, which will restore the interrupted task status and 
return to the interrupted task. 

To perform the connection, the system fills in the TCB 
previously shown, The PSD is constructed (TCB + 8) to 
transfer control to the user in the proper mode and with 
the proper write key. An XPSD TCB instruction is 
placed in the proper interrupt location to complete 
the connection. 



word 



X'OC 



Signal address 



9 10 11112 13 



19120 21 22 23124 25 26 27128 29 30 31 



word 1 







•0 



Interrupt no. /label 



12 3 I 4 5 6 7 I 8 9 10 11 ! 12 13 14 15M6 17 18 19 ! 20 21 22 23I 24 25 26 2?l 28 29 30 3' 



word 2 



CI 



C2 



C3 



2 3 1* 5 6 7 18 9 10 11112 13 14 15 1 16 17 18 19(20 21 22 23 1 24 25 26 27l2S 29 30 3 



C4 



word 3 



C5 



C6 



C7 



C8 



i 2 3 I 4 5 6 718 9 10 III 12 13 14 15116 17 13 I?) 20 21 22 23 1 24 25 26 27 1 2 B 29 30 31 



Word 



The CONNECT function also notes in the INTTAB the num- 
ber of the interrupt being connected so that the interrupt 
can be disarmed and disabled when the foreground program 
is released. Details of the system calls concerned with con- 
nection are given later in this chapter under "System Func- 
tion Call Formats" . 



ARMING, DISARMING, ENABLING, DISABLING 

These functions can be performed by the ARM, DISARM, 
ENABLE, and DISABLE system function calls, which specify 
an interrupt by number or label. As options on ARM and 
DISARM, connection of the interrupt to a task can be per- 
formed, and/or a clock can be set to interrupt at specific 
intervals. 

ARM, DISARM, ENABLE, and DISABLE functions can also 
be performed by operator request through the CINT key-in. 

TRIGGERING OF INTERRUPTS 

An interrupt can be triggered through a TRIGGER system 
function call. The interrupt to be triggered is specified by 
number or by label. TRIGGER calls may be made from any 
foreground task. An interrupt can also be triggered by 
operator request through the CINT key-in. 

SYSTEM FUNCTION CALL FORMATS 

RUN This function call is available only to the fore- 

ground. It has the format 

CAL1,5 address 

where address points to word of the FPT show below. 



X'OC 



is the code for the RUN call 



Signal address is the address of a status word into 

which the system posts one of the fol lowing signals: 

if the program was successfully loaded. 

1 if the space was not available in the fore- 
ground memory area or if there was insuf- 
ficient space in the Foreground Program (FP) 
table to make entries for the public libraries 
needed by the program. 

2 if the requested program did not exist on the 
FP area of the RAD or if an I/O error oc- 
curred attempting to load the program. 

3 if the program is already loaded. 

4 if a previous request has been made to load 
the same program but the program is not yet 
loaded. In this case, the Foreground Root 
Loader is able to notify only the first re- 
quester when the program is loaded. 

5 if the space was not available in the Fore- 
ground Program (FP) table for the requested 
program. 

6 if invalid attempt has been made to load a 
public library. Since public libraries are 
automatically loaded and released by the 
Foreground Root Loader, they cannot be 
loaded via a RUN call. 
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The signal address cannot be a register (addresses 
0-F) and must be in the calling program's portion 
of memory. An invalid signal address results in 
control being transferred to the System or User 
Trap Handler. 

The user should inspect the signal word upon re- 
turn from the CAL, since some of the signals (3, 
4, and 5) are posted immediately by the RUN pro- 
cessor. The signal word should be initialized to 
a value other than 0-6, so that the user can de- 
termine if or when the signal is posted. 

Note that an interrupt is triggered only if the RUN 
request is passed on to the Foreground Root Loader. 
That is, signals 3, 4, and 5 are returned immedi- 
ately by the RUN processor and, in this case, no 
interrupt is triggered. 

Alarms are output by the Foreground Root Loader 
for error conditions 1, 2, and 6. 

Word 1 

I, Interrupt no. /label indicates the contents of the 

Interrupt number/label field (0 for no interrupts; 
1 for interrupt number; 2 for interrupt label). 

This interrupt is triggered by the Root Loader at the 
conclusion (successful or unsuccessful) of the root 
load and initialization. 

Words 2-3 



Ci are the characters in the name of the load mod- 

ule. Thename is left-justified with trailing blanks. 

RLS This function call (Release Foreground Program) is 
available only to the foreground, and has the format 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



>nn> 



X'OB 



-♦— 



~0 1 2 3 I 4 5 6 7 I 8 9 10 llli; 13 14 15' 16 17 IS 19l 20 21 22 23^24 25 26 27 1 28 29 30 31 

word 1 



CI 



t 2 3 I 4 5 6 7 



C2 



C3 



9 10 11! 12 13 14 15116 17 }B 19)20 21 22 23124 25 26 27 ! 2B 29 30 31 



C4 



rd 2 



C5 



I 2 3 I 4 5 6 7 



C6 



9 10 1U12 13 14 15 



Q7 



16 17 18 19120 21 22 23 



C8 



24 25 26 27 1 



where 

X'OB' 



is the code for the RLS call. 



Ci are the characters specifying the name of the 

program. The name is left-justified and filled with 
trailing blanks. An invalid name results in a re- 
turn with no action taken by the system. 



TRAP This function call has the form 

CAI 1,8 address 
where address points to word of the FPT shown below, 
word 



X'14' 

i i \i 5 6 7 



0- 



-0 



Trap address 



8 9 10 111 12 13 U I5I 16 17 18 19 1 20 2! 22 23 1 2* 25 26 ?7 f 28 29 36 ; 



word 1 



12 13 14 15 



16 17 18 19120 21 22 23 



24 25 26 27128 29 30 31 



Abort 



Word 



X'14' 



Trap 



Permit 



Ignore 



is the code for the TRAP call. 



Trap address is the address in the user program that 

receives the requested traps. The address is op- 
tional unless it is the initial call and one of the 
trap bits is set. The address must lie in the calling 
program's portion of memory. 

Word 1 

Bits 1-7 are the Abort flags specifying which traps 
are to be handled by the System. 

Bits 9-15 are the Trap flags specifying which traps 

are to be handled by the user's trap handler. 

Bits 22-23 are the Permit flags specifying that the 

decimal or arithmetic mask in the PSD is to be set 
so that these traps are permitted. 

Bits 30-31 are the Ignore flags specifying that the 

decimal or arithmetic mask in the PSD is to be set 
so that these traps are ignored. 

The Abort, Trap, Permit, and Ignore fields specify 
the changes to be made in the disposition of trap 
occurrences. 

The bits in these fields have the following significance: 

WDG Watchdog Timer 

NAO nonal lowed operation 

UI unimplemented instruction 

PS pushdown stack limit 

FP floating-point arithmetic 

DEC decimal arithmetic 

FX fixed-point arithmetic 

If a control bit has value 1 , the trap is to be handled 
as specified. A value of zero specifies that no change 
is to be made in the handling of that trap. The fields 
are processed from left to right (Abort, Trap, Permit, 
Ignore), with the last-processed code overriding any 
previously processed code. 
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If a given trap condition has a control bit value of 1 in 
both the Abort and Trap fields, the Trap bit will over- 
ride the Abort bit and the user will receive the trap, 
since the Trap bit is the last one processed. 

TRTN This function call (trap return) is of the form 

CAL1,9 5 
No FPT is used. 
EXIT This function call is of the form 

CAL1,9 1 

No FPT is used. 
ABORT This function call is of the form 

CAL1,9 3 

No FPT is used. 

CONNECT This function call (available only to the 

foreground) has the form 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



Word 1 



X'04' 



1 2 3 I 4 5 6 7 







-0 '2 



9 10 11M2 13 14 15 



Interrupt address/ label 



16 17 IB 19120 21 22 23l24 25 26 27 1 28 29 30 31 



word 1 



NR 



TCB address 



1 2 3 14 5 6 7 I 8 9 10 111 12 13 14 15 1 16 17 IB 19 1 20 21 22 23(24 25 26 27 1 28 29 30 31 



optional 



2 

DE 

DI 
CI 



EI 



MS 



is the task start address parameter presence 
indicator (0 means absent; 1 means present). This 
indicator must be 1 . 

is the clock value parameter presence indicator 
(0 means absent; 1 means present). 

specifies that the interrupt is to be disabled 
(DE = 1), or enabled (DE = 0). 

specifies that the connection is to be direct 
(DI =1), or central (DI =0). 

specifies that the task is to be entered with the 
clock group inhibit set (CI = 1), or reset (CI = 0). 

specifies that the task is to be entered with the 
I/O group inhibit set (II - 1 ), or reset (II = 0). 

specifies that the task is to be entered with the 
external group inhibit- set (EI = 1 ), or reset (EI = 0). 

specifies that the task is to be entered in master 
mode (MS = 0), or slave mode (MS = 1). 



DM specifies that the task is to be entered with the 
decimal mask set (DM = 1), or reset (DM = 0). 

AM specifies that the task is to be entered with the 

arithmetic mask set (AM =1), or reset (AM = 0). 

NR is the number of registers to be saved upon oc- 
currence of the interrupt (If connection is central). 
Value is used to denote that 16 registersare to be 
saved. Registers are saved beginning with reg- 
ister 0, and at least four registers must be saved. 

TCB address contains the TCB address for central 

connection. For direct connection, this portion 
of word 1 is unused. 



Start address 



i 2 3~1~4 5 6 7i~8 9 10 11 I 12 13 14 15 1 16 17 18 I9I2O 21 22 23I24 25 26 27 1 28 29 30 31 



optional 



Clock value 



1 2 3 I 4 5 6 7 I 8 9 10 I1U2 13 14 15H6 17 IB ^20 21 22 23I24 25 26 27 1 2 B 29 30 31 



Word Options 

Start address is the starting address of the task if it 

is to be centrally connected. If the task is to be 
directly connected, this is the address of the XPSD 
to be executed in the interrupt location. The user- 
furnished XPSD instruction will be stored in the 
task's interrupt location by the CONNECT function . 



Word 

X'04' is the code for the CONNECT call. 

I? indicates that the address (Io = 0), or the label 

(\y =1), of the interrupt is specified in Interrupt 
address/label . 



Clock value is the value (in units of the clock's 

resolution) to which the clock is to be set. If this 
parameter is absent, no change is made in the in- 
terval. This value should be presented if a task is 
being central ly connected to a clock interrupt. 
Note that the clock value is decremented via an 
MTW, -1 instruction. This parameter is meaning- 
less for a direct connection or if no connection is 
being made. 
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ARM, DISARM These funcHon calls (available only to 

the foreground) are of the form 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



Code 



1 2 3T4 5 6 7 



9 10 111 12 13 14 15 



Interrupt address/ label 



16 1? 18 19120 21 22 23124 25 26 27128 29 30 31 



word 1 



NR 



TCB address 



9 10 11T12 13 14 15T16 17 18 19I2O 21 22 23I24 25 26 27' 2B 29 30 31 



optional 



8 I 2 3 \ i 5 6 7 l l 



optional 



Start address 

~~9 10 11112 13 14 I5I 16 17 IB IV ! 20 21 22 23I 24 25 26 27^6 29 30 3 



Clock value 

"0 1 1 3 I 4 5 6 7 I 8 9 10 111 12 13 14 IS 1 16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 3 



where 

Code = X'03 1 specifies DISARM 

= X'04' specifies ARM 

12 has the same significance as in the CONNECT call. 

If P 1 =1, a connection is performed and the parameters in 
word 1 and the optional words assume the same significance 
as in the CONNECT call. 

If Pi = 0, no connection is performed and the remainder of 
the parameters in word 1 are ignored, except for the DE 
parameter in the case of an ARM call. 

The restofthe coding is identical to that for theCONNECT 
function call . 

ENABLE, DISABLE, TRIGGER These function calls (avail- 

able only to the foreground) are of the form 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



Code 



1 2 3M 5 6 7 

where 

Code 



-0 '2 



9 10 TTT12 13 14 15 



Interrupt address/ label 

16 17 18 1?l 20 21 22 23t 24 25 26 27 1 28 2? X 3' 



X'00' specifies TRIGGER 
X'OT specifies DISABLE 
X'02' specifies ENABLE 



l„ specifies that either the address (I2 - 0), or the 

label (I2 - 1), of the interrupt is specified in In- 
terrupt address/label. 

MASTER, SLAVE These function calls (available only to 

the foreground) are of the form 

CAL1,5 address 

where address points to word of the FPT shown below. 

word 



Code 


0- 




u 


1 


2 3 14 5 6 7 


9 9 


10 111 12 13 14 I5I16 17 18 19 1 20 21 22 23 1 24 25 26 27 1 28 29 30 31 



where 

Code = X'07' specifies SLAVE 
= X'08 1 specifies MASTER 

SEGL0AD This function call is of the form 

CAL1, 8 address 

where address points to word of the FPT shown below. 

word 



x'or 



i 2 3U 5 6 7 



optional 



9 10 11 I 12 13 14 15 



Segment number 



16 17 IB 19120 21 22 23124 25 26 27128 29 30 31 



0- 



-0 



End-action interrupt 



12 Tt"4 5 6 7~Te 9 10 llll2 13 14 15M6 17 IB ]?\ 20 21 22 23 1 2A 25 26 27 1 28 29 30 31 



Dptional 



1 2 3 14 5 6 7 ! 8 9 10 1 lT 1 2 13 14 



Address to process error returns 



I5l 16 17 18 19120 21 22 23l24 25 26 27l23 29 30 



i/here 

Word 

X'OT is the code for the SEGLOAD call. 

P. indicates the presence or absence of word 1; 

means absent, 1 means present. 

P„ indicates the presence or absence of word 2. 

T indicates whether control is to be returned fol- 

lowing the call or transferred to the starting loca- 
tion of the segment at the conclusion of the seg- 
ment load, 

for return to calling program. 

1 for transfer to new segment (only valid 
if P, =0). 
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Word Options 

I indicates the contents of the end-action interrupt 

field (foreground only): 

I = indicates no end-action. 

I = 1 indicates an interrupt address. 

I = 2 indicates an interrupt label. 

If end-action is specified, the request to load the seg- 
ment will be queued, and control will be returned im- 
mediately to the calling program. The calling program 
can then exit and release control while the segment is 
being loaded. If end-action is not specified (I = 0), 
control will not be returned until the segment is loaded. 
The user is responsible for checking the status of the 
load if end-action is selected. 



Address to process error returns This is the address 

of the user's routine for processing any error or ab- 
normal returns received while attempting to load 
the overlay segment. The codes returned will be 
identical to those of the READ CAL since a READ 
CAL is used by SEGLOAD to load the segment. 
If this address is not present and an error occurs, 
a foreground program will be exited or a bock- 
ground program aborted. If an error is detected 
in the user's PCB or OVLOAD table, the User or 
System Trap Handler will be entered. 



WAIT A background program will enter the "wait" state 

through this function call if an ! ATTEND card was included 
in the control commands for the job. Normally, a back- 
ground program would use WAIT after typing an alarm to the 
operator that requires an operator response. While in this 
state, the Control Task waits for a key-in from the operator 
specifying the disposition of the background program. The 
operator may specify continue (C), continue from OC(COC), 
or abort (X). 

This function call is of the form 

CAL1,9 9 

No FPT is used. 



TIME Programs may interrogate the Monitor to determine 

the time of day and date. 

This function call is of the form 

CAL1, 8 address 
where address points to word of the FPT shown below. 

word 



X'10" 



2 3 U 5 4 7 



Address 



9 10 11112 13 I* 15116 17 IB 19120 21 22 23124 25 26 27128 29 30 3 



X'10' 



is the code for the TIME call. 



Address is the address of the first word of a 4-word 

block which is to receive the time and date. In sys- 
tems without Job Accounting or if a data has never 
beeninputvia a "DT" key-in, the 4-word block 
will not be modified. This block contains EBCDIC 
characters as shown below. 

word 



h 


h 


: 


m 


word 1 






^ 


m 


6 


m 


o 


word 2 


n 


*> 


d 


d 


word 3 


/ 


1 


y 


y 



hh is the hour (0 £ hh s 23). 

mm is the minute (0 s mm S 59). 

mon is the month (3-letter abbreviation). 

dd is the day (01 < dd < 31). 

yy is the year (00 < yy < 99). 
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6. OVERLAY LOADER 



OVERVIEW 

The Overlay Loader is a two-pass processor that creates pro- 
grams in overlay form. Modules In Sigma 5/7 Standard Ob- 
ject Language format are converted to overlays in absolute 
core image form in accordance with the Loader control com- 
mands. The Loader creates programs for execution in either 
foreground or background, prepares standard processors for 
execution under the Job Control Processor, and creates 
Public Libraries. 

The Overlay Loader permits the user to assemble, load to 
background or foreground areas, and execute programs with 
minimal control information. The default cases documented 
in this section for each control command will handle most 
normal situations. 

The control command structure permits the user to tailor the 
loading procedure for a wide variety of situations, and the 
control commands add control and flexibility by overriding 
default cases and adding options. 

The size of the program that can be loaded is a function of 
the size of the symbol table and available core storage at 
load time, rather than the amount of core memory that the 
program occupies at execution time. Therefore, the Over- 
lay Loader may load user programs equal in size to the max- 
imum available area in core at execution time, even though 
this area is not available at load time. 

The loading of mixed media is al lowed, and all library load- 
ing will be from library files on the RAD. A library need 
not be ordered. 



FUNCTIONAL FLOW 

The options specified on the IOLOAD control command are 
scanned and those not specified are assigned their default 
values. A :ROOTor :SEG control command is scanned to de- 
termine the source of the binary object modules from which 
the segment will be created, and to define its linkage. 

The Loader makes the first pass over the binary object mod- 
ules, allocating the segment's labelled COMMON blocks 
(dummy sections) and control sections. It concurrently builds 
a symbol table of DEFs and unsatisfied REFs. Object mod- 
ules input from non-RAD devices are saved on a temporary 
RAD file (XI). 

After the last object module for a segment has been input, 
the Libraries are searched. Pointers to the selected library 
object modules are saved and their DEFs and REFs are added 
to the symbol table. At the end of a path, segment symbol 
tables are written on temporary RAD files. The blank 
COMMON base is set at the end of the first pass. At this 
point, all the Loader control commands except :ASSIGN 
have been input. 



During the second pass, each segment's binary object mod- 
ules and selected library modules are loaded. The absolute 
core image of each segment is created and written on the 
program file. Part two of the ROOT (the INTTAB, DCBTAB, 
OVLOAD table, the Temp Stack, and any DCBs created by 
the Loader) is built at the end of the second pass. If a MAP 
has been specified, it is output. If an output file used by 
the Loader overflows, an attempt is made to output all poss- 
ible MAP information. The Loader returns to the Monitor 
by calling either the EXIT or ABORT function. 

LIMITATIONS 

There are certain limitations in the use of the Overlay 
Loader due to total system considerations or because the 
efficiency of the Loader could otherwise be degraded. 

1. No discontinuous programs will be output by the Over- 
lay Loader. The Monitor SEGLOAD function reads 
only a contiguous core image. Since each discontin- 
uity would result in at least one additional RAD access, 
considerable degradation of the run-load process for 
the foreground would result. 

2. The contents of reserve areas within a program will not 
be predictable at execution time unless initialized in 
some manner (e.g., by DATA statements). Labeled 
COMMON will be unpredictable unless initialized by 
a DATA statement. Blank COMMON is not written to 
the RAD and is not loaded as part of the program. 

3. Allocation of program, COMMON, and Labeled 
COMMON within a program area is generally de- 
termined by the Loader. 

4. Only relocatable modules or those containing absolute 
origins falling within the limits of the segment currently 
being loaded will be allowed. 

5. No implicit loading of segments will take place at exe- 
cution time. Only explicit calls to the Monitor SEG- 
LOAD function will read in overlay segments. Thus, 
the overlay structure must be accurately defined at load 
time to coincide with explicit calls in the user's program. 

OVERLAY PROGRAMS 

An overlay program is defined as the collection of absolute 
core image segments generated by the Overlay Loader, The 
Loader produces background overlay programs (including 
processors) and foreground overlay programs. Note that 
the Overlay Loader loads only programs; a foreground pro- 
gram may consist of one or more tasks. 



OVERLAY STRUCTURES 

An overlay program is generally composed of a root and 
several overlay segments; however, it can consist of only 
a root without overlay segments. The root segment is resi- 
dent at all times during the execution of a program; overlay 
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segments are resident only when they have been explicitly 
read by calls to the Monitor SEGLOAD function. 

Each segment is created from one or more binary object mod- 
ules and associated library routines. The segments are as- 
signed arbitrary identification numbers (except for the root 
which is always segment 0) that must be unique within the 
overlay program. Segment numbers are used by the Overlay 
Loader and the Monitor SEGLOAD function. 

The overlay structure is communicated to the Loader with 
the :ROOT and :SEG control commands. Since each over- 
lay segment is created and stored on the RAD as a continuous 
string of bytes in absolute core image form, data in reserved 
areas of the program segment is not predictable. Note that 
reserved areas and data blocks will effectively be reini- 
tialized each time that an overlay segment is read in by 
SEGLOAD. The structure formed by segments that can 
exist in core at any one time is called a path. 

The overlay program example given in Figure 3, consists of 
a root (segment 0) and overlay segments 1 through 15. The 
segments (horizontal lines) are numbered in the order in 
which they were built by the Loader. There are nine paths: 



1. 0,1,2 

2. 0,1,3 

3. 0,4 

4. 0,5,6,7 

5. 0,5,6,8 



6. 0,5,9,10,11,12 

7. 0,5,9,10,11,13 

8. 0,5,9,10,14 

9. 0,5,9,15 






1 


2 








3 




4 








5 


6 


7 








8 




12 


9 


10 


11 




13 


14 






15 









Figure 3. An Overlay Program 

OVERLAY RESTRICTIONS 

Communication between segments by external DEF/REF link- 
ages is permitted with the following restrictions: 

1. The Loader will satisfy a DEF/REF linkage only within 
a path. 



2. A segment in one path cannot reference a segment in 
another path. For example, segment 2 must not refer- 
ence any of segments 3-15. 

3. The user must ensure that any segments that intercom- 
municate are in core. For example, if segment 5 ref- 
erences segments 6 and 8, then segments 6 and 8 must 
have been explicitly loaded. If segment 8 references 
segments 5 or 6, these segments must have been explic- 
itly loaded since the loading of segment 8 does not 
cause the implicit loading of segments 5 and 6. 

4. Identical definitions cannot be used in segments that 
are in the same path. For example, segments 5 and 13 
cannot have identical definitions because they are both 
in path (0,5,9,10,11,13). 

5. Identical definitions and references may be used in seg- 
ments of different paths that do not involve a common 
segment. For example, if segments 7 and 15 reference 
identical definitions in segments 6 and 9, the Loader 
will link the reference in 7 with the definition in 6 and 
the reference in 15 with the definition in 9. 

6. Identical references in segments of different paths may 
be made to a definition in a segment common to both 
paths. For example, segments 6 and 9 can each refer- 
ence a definition in segment 5 because 5 is a common 
segment in the two paths (0,5, 6,7) and (0,5,9, 10, 14). 

7. A segment that is common to two paths cannot reference 
identical definitions in the different paths. For exam- 
ple, segment 10 cannot reference identical definitions 
in segment 12 and 13, even though segments 12 and 13 
are in different paths. 

Where possible, the Loader will warn the user about errors 
in overlay structure and segment communication; however, 
it is the user's responsibility to attempt a reasonable, work- 
able overlay contruction. 



OVERLAY CONTROL COMMANDS 

The prime Overlay Loader command, I OLOAD, is read by 
the Job Control Processor and causes the Overlay Loader 
processor to be read into the background and executed. All 
Loader subcommands are identified by a leadingcolon (e. g. , 
:SEG). They are read from M:C and logged onto M:LL. 
Blank cards are passed over without comment. When a Mon- 
itor control command is encountered, the Loader completes 
the load process and exits to the Monitor. 

Note that ! EOD must occur only as a terminator for object 
module input; its use is illegal for terminating the Loader 
control command stack. 



SYNTAX 

The syntax for Overlay Loader control commands is identical 
to that defined for the RBM Monitor (except for MODIFY 
control commands). 
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ORDER OF CONTROL COMMANDS 

The control command stack is divided into major divisions 
or substacks, which must occur in the following order: 

lOLOAD 

:ROOT 

:SEG 

{•.PUBLIB} 

:SEG 

:ASSIGN . 

\ (Monitor control command) 

TherCOMMON, :LCOMMON, :LIB, INCLUDE, :EXCLUDE, 
:RES, and :MODIFY control commands may occur in any 
:ROOT or :SEG substack and apply only to that root or seg- 
ment. The :ASSIGN control commands must follow all other 
commands in the stack. The :PUBLIB control command is 
unique, replacing :ROOT, :SEG, and :ASSIGN substacks. 

A ROOT or SEG substack has the following order: 

ROOT or :SEG 

INCLUDE 

EXCLUDE 

LIB 

LCOMMON 

RES 

COMMON 



These commands may occur 
in any order 



Binary Object Module 



Binary object modules are in- 
cluded at this point in the 
substack only if the input 
v device specified on the 
preceding :ROOT or :SEG 
command is the same as the 
"C" device. 



Binary Object Module 
r 

:MODIFY 

:MODIFY 
The PUBLIB substack has the following order: 



PUBLIB 
INCLUDE} 

exclude! 



Binary Object Module. 



Binary Object Module 

r 

:MODIFY 



These commands may occur 
in any order. 

Binary object modules are 
included in the substack 
only if the input device 
'specified on the PUBLIB 
command is the same as 
the "C" device. 



:MODIFY 

lOLOAD The ! OLOAD control command signifies that 

the Overlay Loader Processor is to be executed in the back- 
ground area. Any error on the ! OLOAD control command 



causes the Loader to abort. Recovery consists of correct 
the error and reloading the entire job. 



ting 



If an ! OLOAD control command is continued to another 
card, the continuation command must have a colon (:) in 
column one instead of an exclamation (!) character. 

The form of the command is 



r 



lOLOAD [(option )(,optionj. . . (,option )] 



where the options are 

GO specifies that the Loader is to input all object 

modules from the GO file and form a root. The only 
other control commands recognized in this mode 
are :RES, :INCLUDE, :MODIFY, and :ASSIGN. 
Ail other commands are considered illegal. 

GO, LINKS specifies that the Loader is to form a 

link type overlay structure from GO in the follow- 
ing manner: module 1 is identified as the root (seg- 
ment 0); module 2 is identified as segment 1 and is 
linked to the root, , , ,; module n is identified as 
segment n-1 and is linked to the root. 

Module 2 (ident 1) 



Module 1 (root) 



Module 3 (ident 2) 



Module n (ident n-1) 



Libraries are searched at the end of each segment. 
Only :MODIFYand tASSIGN commandsare honored. 
The user must have explicit SEGLOAD calls to load 
segments 1 , 2, . . . n. No implicit calls are built 
by the Loader. 

PUBLIB, name [",name„,name„1 specifies that the 

named Public Libraries are to be resident when the 
loaded program executes, and that the Loader is to 
establish the appropriate linkage. Name; is the file 
name of a Public Library in the Foreground Programs 
area of the RAD, The PUBLIB keyword may not be 
used when a Public Library is being created, (i.e., 
one Public Library cannot reference another Public 
Library). 

LIB [,USER,SYSTEM] specify the Libraries to be 

searched following each segment. The order of 
the keywords USER, SYSTEM defines the order of 
the search. If the USER or SYSTEM keywords are 
omitted, and only the LIB keyword is specified, 
the Library search is suppressed. If the LIB option 
is omitted, the Loader searches the System Library 
after each segment. 

Note: The : LI B control command overrides this 
option for the segment in which it appears 
(see below). 
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I RATIO [»f wa /' wc Q specifies whether the program 

being loaded is to execute in foreground or back- 
ground. If the option is omitted, the program will 
execute in the background area defined at SYS GEN. 
The "fwa" and "Iwa" parameters are hexadecimal 
values denoting the first word address (on a double- 
word boundary) and last word address of the area 
within which the program will execute. The PCB 
will be located at the FWA specified. 

For foreground programs, the default "fwa" is the 
FWA of the foreground area (K:FGDBG2) and the 
default " Iwa" is end of memory (K:FGDEND). 

For background programs, the default "fwa" is the 
FWA of the background area (K:BACKBG), and 
the default" Iwa" is the end of background defined 
at SYSGEN (K:FGDBG2-1). If the "fwa" speci- 
fied for a foreground program lies in the background 
area, the background will be checkpointed when 
the foreground program is loaded. If the "fwa" 
and "Iwa" specified for a background program ex- 
ceed the limits of background at time of loading, 
the program is still loaded and may be executed by 
changing the upper limit of background. Note 
that "Iwa" is an indicator of upper limit. If the 
program exceeds this limit, the user is warned but 
loading is not inhibited (except when a Public Library 
is being created). If the program loads in less space, 
the shorter area will be output in the header. 

TASKS, value specifies the number of tasks in this 

program which are to be connected to interrupts. 
The option is used to allocate the INTTAB, and 
thus has meaning only for foreground programs. 
The default is for Background and Public Libraries; 
1 for Foreground. The "value" parameter is a 
decimal number. 

TEMP, value specifies the number of words to allo- 

cate for the Temp Stack. The Temp Stack is lo- 
cated in part two of the root. The default size for 
a foreground or background program is 200 words. 
Public Libraries do not have Temp Stacks. There- 
fore, the option may not be specified when a Public 
Library is being created. The "value" parameter 
is a decimal number. 

FILE,area,name specifies the RAD area and file 

name of the output file to which the loaded pro- 
gram is to be written (hereafter referred to as the 
Program File). The default assignment of the pro- 
gram file is OV in the Background Temp area. If 
the Background Temparea (BT) is specified, the file 
name must be OV. When a foreground program is be- 
ing loaded, eitherthe Foreground Programsarea (FP), 
or Background Temp area (BT), must be specified. 
When a Public Library is being created, the Fore- 
ground Programs area (FP) must be specified. 

MAP ['{ PR< all AM 11 specifies that a MAP of the 

program is to be output to M:LO. If no keyword 



follows MAP, a short map consisting of information 
about program allocation and overlays is output. 
If PROGRAM keyword is given, external definitions 
and control section designations for each segment 
are listed without library definitions. For the ALL 
keyword, both program and library definitions are 
listed. In default, no MAP is output. (Diagnostics 
and unsatisfied references are still listed on M:LL,) 

BOUND, value sets the loading (and execution) ori- 

gin for each object module to the next higher mul- 
tiple of the bound value (e.g., if BOUND = 100, 
then an origin would change from 3EF to 400). The 
"value" parameter must be a hexadecimal number 
less than or equal to 1000 and a power of 2. Sug- 
gested values are 10, 100, or 1000. The BOUND 
does not apply to Library modules. If BOUND is 
not specified, the Loader begins each module on 
a doubleword boundary. 

UDCB,value specifies the number of unnamed DCBs 

to be allocated by the Loader. (See "Loader- 
Generated Items" for details.) The "value" param- 
eter is a decimal number. 

STEP specifies a "WAIT" after loading each module 

from paper tape. Used in RBM ATTEND mode. 

Example: Form Root From GO File Modules 

! OLOAD GO,(TEMP,300),(MAP,PROG),(UDCB,3) 



This example specifies that the Loader is to form the root 
from object modules located on the GO file, allocate 300 
words for the Temp Stack, output a PROGRAM map, and 
allocate three unnamed DCBs. 



IR00T The ROOT control command is used to spec- 

ify the object modules from which the root segment is 
to be created. The ROOT command must precede all 
SEG commands. 

The form of the command is 

AootRentryW, 1 "^ Y.-.f/T ) 
I \°pt">"-\) \°p tlon n /_ 



where 



ENTRY,def specifies the location at which exe- 

cution will commence after the root is loaded 
at execution time. The def parameter must be 
an external definition (1-8 EBCDIC characters) 
in the root segment. This entry point overrides 
all subsequent entry addresses encountered in 
loading. The default entry address is the last 
transfer address encountered in the nonlibrary 
object modules of the root. 
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Input options are of the form 
DEVICE,rype[,PACK]' 



The form of the command is 



FILE,area,name 
lOPLB,label 



[, value! 



whe 



DEVICE, type specifies the input device in the 

format yyndd. 

where 

yy is a device type code. 

n is the IOP to which the device is connected. 

dd is the hardware device number of the 

device (e.g., CRA03,9TA81 ). 

PACK specifies that the input is from 7-track 
magnetic tape with packed binary format. 

FILE, area, name specifies the RAD area and name of 

the input file. If the Background Temp area (BT) 
is specified, the file name must be GO. Note 
that a file may be used as input to more than one 
segment (in different paths). A named file is re- 
wound each time it is specified; the GO file is not. 

OPLB, label specifies the operational label from 

which the object module(s) will be input. The 
" label" parameter must be a 2-character standard 
system operational label. 

value either a decimal number (1 5 value < 8191) 

that specifies the number of object modules to in- 
put from the specified device/file; or the text 
string, EOD, which means to input from the speci- 
fied device/file until an ! EOD is encountered. If 
value is omitted, one object module will be input 
from the specified device/file. 

If there are no input options on the ROOT control command, 
one object module will be input from the GO file. Note 
that the order of the subfields determines the order in 
which the object modules are loaded. 

Example: Form Root From Input File 

:ROOT (FILE,D1 ,BETA,3),(ENTRY,START) 



This example specifies that the root is to be formed from the 
three object modules in a file called BETA located in the 
Dl RAD area. After loading,, execution is to commence at 
the location defined by the external definition START. 



:SEG The SEG control command is used to define a 

segment's overlay linkage and to specify the object mod- 
ules from which the segment is to be created. 



y^SEG (LINK,ident 1 [oNTO,identJ) f,(EXLOC,addr), 



: 



] 



(ENTRY,def)Y In P/ ) (^ \] 

yoprion^ \ 0P n/J 



where 

LINK,ident] specifies the identification number of 

the segment being loaded. The ident] must be 
specified and must be the same number used within 
the overlay program to call in the segment at exe- 
cution time by SEGLOAD. The'Sdent-)" parameter 
must be a decimal number between 1 and 32,767. 

ONTO,ident2 specifies the identification number 

of the segment (which must have been previously 
loaded when this control command is interpreted) 
to which this segment is linked as an overlay. If 
ident2 is absent, ident] is linked onto the root. 
The " idento" parameter must be a decimal number 
between and 32,767 (0 denotes the root). 

EXLOC,address specifies an optional execution ad- 

dress for loading of this segment. The "address" pa- 
rameter isa hexadecimal value. This value will be 
bounded by either the specified or default BOUND, 
If the EXLOC option is omitted, the segment will 
be located at the first bounded address following 
the segment that this segment is linked to. 

ENTRY,def specifies an entry point for the segment. 

The"def" parameter must be an external definition 
in an input module of the segment. The value of 
the "def" overrides any transfer addresses encoun- 
tered in loading of the segment. The default entry 
address is the last transfer address encountered in 
loading nonlibrary ROMs. 

The input operations are the same as for the ROOT control 
commands. If there are no input options on the SEG con- 
trol command, a single object module from the GO file 
will be input. 

The ROOT and SEG control commands must be input in an 
order determined by the overlay structure of the program. 
The segments in the example given in Figure 4 have been 
numbered to illustrate this order. Basically, segments are 
input one path at a time, with the restriction that segments 
common to more than one path are input only once. 

Example 1 . 

The following control commands define the overlay structure 
of Figure 4. This example specifies that one object module 
for each segment will be input from the GO file. 



ROOT 

SEG (LINK,1,ONTO,0) 
SEG (LlNK,2,ONTO,l) 
SEG (LINK,3,ONTO,l) 
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SEG 


(LINK,4,ONTO,0) 


SEG 


(LINK,5,ONTO,0) 


SEG 


(LINK,6,ONTO,5) 


SEG 


(LINK,7,ONTO,6) 


SEG 


(LINK,8,ONTO,6) 


SEG 


(LINK,9,ONTO,5) 


SEG 


(LINK,10,ONTO,9) 


SEG 


(LINK, 11, ONTO, 10) 


SEG 


(LINK,12,ONTO,ll) 


SEG 


(LINK,13,ONTO,ll) 


SEG 


(L1NK,14,ONTO,10) 


SEG 


(LINK,15,ONTO,9) 






1 


2 








3 




4 








5 


6 


7 








8 


9 


10 


11 


12 




13 


14 






15 









Figure 4. Overlay Example 



Example 2. 



The following control commands define the overlay structure 
illustrated in Figure 5. This example specifies that one ob- 
ject module for each segment will beinputfrom the GO file. 

ROOT 

SEG (LINK,10,ONTO,0) 

SEG (LINK,5,ONTO,10) 

SEG (LINK,25,ONTO,10) 

SEG (L1NK,103,ONTO,0) 






10 


5 


25 


103 











Figure 5. Object Module from GO File 



BINARY OBJECT MODULES 

The Loader inputs binary object modules from mixed media 
according to the input files and devices specified on the 
ROOT, SEG and PUBLIB commands. Files may be blocked 
or unblocked. Non-RAD input is written to a temporary 
RAD file for Pass 2. Binary modules are read sequentially 
from each RAD file. Each RAD file, with the exception of 
GO, is rewound each time that it is named as input on a 
control command. Therefore, multiple inputs from a file 
(other than GO) result in the file being reread from the 
beginning. 

In this example, 



SEG (LINK,204,ONTO,0),(FILE,FP,PROG1,2) ; 
(FILE,BT,GO,4) 

SEG (LINK,205,ONTO,0),(FILE,FP,PROG1 ,5); 
(FILE,BT,GO,2) 



the first access to the PROG1 file (in SEG 204) would 
result in the first two modules being loaded from the file. 
The second access (in SEG 205) would result in the first 
five modules of the file being loaded (not modules 3-7). 
The GO file is read contiguously throughout a pass, no 
matter how many accesses are made. In segment 204, the 
first four object modules from GO would be loaded. In 
segment 205, the next two modules (5 and 6) from GO 
would be loaded. 



:LIB The LIB control command specifies the library 

search for one segment only (i.e., the segment identified 
by the preceding ROOT or SEG command). It overrides 
the library search specified by the LIB option on the 
OLOAD control command. 



The form of the command is 



/uBfJUSER^YSTEM)] 



where option keywords USER and SYSTEM are used to denote 
the libraries and order of search; e.g., : LIB (USER) would 
cause only the USER library to be searched for that segment. 
If neither USER nor SYSTEM is specified, library search 
(except for Public Library) is suppressed for that segment. 



Overlay Control Commands 59 



Example: 

In Figure 6, assume an overlay program with four ROMs on 
the GO file; with segments 0, 1, and 2 coded in Macro- 
Symbol, and segment 3 coded in FORTRAN IV-H. 





Segl 


Seg 


ROM 2 
Seg 2 


ROM 1 


ROM 3 
Seg 3 




ROM 4 



[EXCLUDE The EXCLUDE control command inhibits li- 

brary search and linkage for the named definition(s) even 
though an external reference occurs in a module of the 
segment. 

The form of the command is 



: EXCLUDE (def ] Tdef^ . . . ,def 1 ) 



whe 



Figure 6. : LIB Command Usage 



def; is the EBCDIC symbol of an external reference 

contained in a module of the segment. However, 
def; must not occur as an external definition in a 
lower level segment of the path. The symbol may 
be one to eight EBCDIC characters. Note that 
EXCLUDE also inhibits linkage with the specified 
Public Library for the given symbols. 



To speed up the load process, the : LIB command in the stack 
of commands given below would be used to specify a search 
of the System Library in segment 3, and the no-library 
search option would be specified on the lOLOAD command. 



lOLOAD (MAP,ALL),LIB 
ROOT 

SEG (LINK,1) 
SEG (LINK,2) 
SEG (LINK,3) 
LIB SYSTEM 



INCLUDE The INCLUDE control command allows rou- 

tines to be loaded from libraries when no reference to the 
routine has been made in any module of the segment. 

The form of the command is 



Example: Exclude Search For Named Routine 



X:INCLUDE (def f,def 2 ,...,def 1) 



where 

def. is the EBCDIC symbol of a definition con- 

tained in the library routine to be loaded. The 
symbol may be one to eight EBCDIC characters. 
The def; must be available in a library specified 
in a preceding : LIB command or the LIB option on 

the lOLOAD command; any unfound def. results 

... i 

in an error diagnostic. 

Example. Load Two Routines From Library 



r 



INCLUDE (9SETUP/7SET) 



In this example, the routines 9SETUP and 7SET are to be 
included in the load from a library previously specified in 
the search criteria. 





Seg 1 


Seg 


DEF SIN 
Seg 2 


DEF A 

REF TAN, SIN 




REF TAN 



Figure 7. : EXCLUDE Command Usage 

In this example, the tree structure illustrated in Figure 7 
shows a routine called SIN in segment 1 that has the same 
name as a library routine, and is referenced in an earlier 
segment (Seg 0). The command 



r 



EXCLUDE (SIN) 



inhibits library search and linkage for the named routine 
only so that the TAN routine would be included in the root 
but the SIN routine would not. 



[COMMON The COMMON control command specifies 

that the Loader is to set the base of Blank COMMON at 
the end of the segment identified by the preceding ROOT 
or SEG control command (see "FORTRAN Interface" for 
details). If this control command is not included, Blank 
COMMON is set at the end of the longest path. Only one 
COMMON control command may be used in a control com- 
mand stack. 
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The form of the command is 
X: COMMON 

The specification field must be blank. 



:RES The RES control command allows the user to re- 

serve and name one or more areas at the end of the segment 
for load-time or run-time debug purposes (see "MODIFY" 
control command for further comment). 

The form of the command is 

:RES (def,size), |,(def,size) ,. . . ,(def,size) 1 



def creates an external definition whose value is 
the FWA of the reserve area. The definition must 
be unique within the path. 

size is a decimal value specifying the number of 

words in the reserve area. 



Example: Reserve Two Areas at Segment End for Debug 
Purposes 

'RES (PATCH1,5),(PATCH2,10) 



In this example, two areas are being reserved at the end 
of a given segment; the first (PATCH1) comprising an 
area of five words and the second (PATCH2) an area of 
ten words. 



ILCOMMON The LCOMMON control command allows 

the user to determine the allocation of labeled COMMON 
blocks (DSECTs) within the root and overlay segments of the 
program. (See "FORTRAN Interface-Labeled COMMON" 
for a discussionof restrictionsconcerning labeled COMMON 
allocation and initialization.) 

The form of the command is 



/rLCOMMON (blockname^ize). ,(blockname,size) , 



Zl 



., (blockname,size) 

n J 



size is a decimal value specifying the largest word 

size needed for the allocated block. If 'size' is 
omitted, the first size encountered will be used. 

Example: Specify Allocation of a Labeled COMMON Block 

In the overlay structure given in Figure 8, seg references 
a Labeled COMMON block A of 50 words; seg 1 references 
a Labeled COMMON block A of 100 words; seg 2 references 
a Labeled COMMON block A of 60 words. 





Seg 1 


Seg 


References a Labeled 
COMMON block A 
of 1 00 words 

Seg 2 


References a 
Labeled COMMON 
block A of 50 words 




References a Labeled 
COMMON block A 
of 60 words 



blockname is the one- to eight-character EBCDIC 

name of the labeled COMMON block or DSECT. 



Figure 8. DSECT Allocation Example 

Normally, the Loader would allocate block A with the size 
first encountered (50 words), and would output a diagnostic 
alarm when the second block of 100 words in seg 1 is 
encountered. 

However, the :LCOMMON command inserted in the deck 
structure 



lOLOAD (MAP,ALL) 
ROOT (DEV,CRA03) 
LCOM (A, 100) 
SEG (LINK,1),(DEV,CRA03) 
SEG (LINK,2),(DEV,CRA03) 



would set the size of block A to 100 words. 



:M0DIFY The MODIFY control command modifies core 

locations of relocatable programs at load time. Core lo- 
cations in either root or overlay segments can be modified. 
Since the reserved area at the end of a segment (allocated 
with the RES command) is output to the RAD as part of the 
segment, that area can be used for "patches" that will be 
read in with the segment at execution time. The MODIFY 
commands must be input at the end of the ROOT, SEG, or 
PUBLIB substack for the segment being modified. If the GO 
option is specified, the MODIFY commands must follow any 
RES or INCLUDE commands and precede any ;ASSIGN com- 
mands. If the (GO, LINKS) option is specified, the MODIFY 
commands must be ordered by segment number and follow the 
OLOAD command. 
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The form of the command is 



:MODIFY [(SEG,ident),](LOC,address),word 1/ . . . Hword 1 



SEG,ident specifies the identification number of 

the segment to be modified. This option is only 
necessary when the (GO, LINKS) option has been 
specified. If this option is omitted, the segment 
identified by the preceding ROOT, SEG, or 
PUBLIB command will be modified. 

LOC,address specifies the relative location of the 
first 32-bit word to be modified. The address must 
be expressed as an external definition name plus 
or minus an optional hexadecimal or decimal off- 
set. Hexadecimal values are distinguished from 
decimal values by a period preceding the hexadec- 
imal value (i.e., .A9B). 

word; specifies the word to be inserted (right- 

justified) at the ith location. The word can be 
expressed as: 

1. A signed (plus sign (+) optional) hexadecimal 
or decimal value that cannot be enclosed in 
parentheses. Hexadecimal values are pre- 
ceded by a period. 

Examples 

-6, 100, .2A, -.AF 

2. An external name plus or minus an optional 
offset that cannot be enclosed in parentheses. 
The offset can be either a hexadecimal or 
decimal value. Address resolution for the ex- 
ternal can be specified by using the SYMBOL 
notation: rr(name) ± offset 

where 

rr = BA, HA, WA, or DA 

Word resolution is assumed by default. Note 
that BA(ALPHA) + 3 is legal; BA(ALPHA + 3) is 
not. If the name specified has not been de- 
clared an external somewhere in the overlay 
segment's path, it will be listed as an unsat- 
isfied REF on the MAP. 

Examples: 

TABL+ .F, TABL-1, TABL, HA(TABL) 

3. A symbolic instruction that must be enclosed 
by parentheses. The mnemonic field of the in- 
struction must be an EBCDIC operation code 
that immediately follows the left parenthe- 
sis. (The floating-arithmetic, floating-shift, 



decimal, and byte string instructions have not 
been implemented.) The register and index 
fields can only be signed hexadecimal or 
decimal values. The address field can be 
either a signed hexadecimal value, a signed 
decimal value, or an external name plus or 
minus an optional offset. 

Examples: 

X:MODIFY (LOC,MAP + . F0),(B PATCH + 6) 



:MODIFY (LOC,PATCH + 6),(LI,6 BA(TABL)), — l 
4LW,9 *WA(VAL) + 9,6),(B MAP+. Fl) 



:MODIFY (SEG,0),(LOC,. 140),. 3F,-.F, 250,-1 



:MODIFY (SEG,1),(LOC,CCI + .80),(LI,5 0), 



I] 



(BAL,15SERCHTAB),(MTW,-1 FLCHG),(BLEZ*CC1 +5),-, | 
(LB,6 0,5) ,(STB,6 *WA(TABL) + 1 ,5),{LW,0 . 4E) 



:MODIFY (SEG,3),(LOC,FPTLO),M:LO+.11000000,- 



.F0400090,ERRIO,ABNIO,BUF1 ,80,0 



In reporting MODIFY command errors, any EBCDIC string, 
decimal number, or hexadecimal number that is separated 
by a comma, blank, plus sign, or minus sign (ignoring pa- 
rentheses) is counted as an item. An example of items on 
a MODIFY command is given in Figure 9. 

: ASSIGN The ASSIGN control command is used to 

create, initialize, or modify DCBs at load time. If the DCB 
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Figure 9. :MODIFY Command Items Example 



I 



is in the program's DCBTAB table, it will be either initial- 
ized or modified. If the DCB is not named in DCBTAB, the 
Loader will build the DCB from the parameters on the 
:ASSIGN control command in an unnamed DCB's entry. An 
error diagnostic is output if an unnamed DCB entry is not 
available (see "Load Time ASSIGN"). 

The formatand options are identical to the Monitor [ASSIGN 
control command. The :ASSIGN control commands must be 
the last commands in the control command stack. 

Example: Assign a DCB at Load Time 

/ASSIGN (F:2,LPA02),VFC,(RECL,133) 



In this example, the DCB F:2 is assigned to the line printer. 
Vertical format control is specified, so that the first byte in 
each record controls the spacing on the line printer. Al- 
though 133 bytes are output for each record, only the last 
132 bytes are printed because VFC is specified. 



When the specified object modules have been input, the 
Loader searches the libraries (specified on the OLOAD con- 
trol command or the System Library by default) to satisfy 
any unsatisfied primary references. If a COMMON, labeled 
COMMON block, or other DSECT is encountered in an object 
module of the Public Library, the load process is aborted and 
an error diagnostic is output. If the severity level exceeds 
zero in the load process, the Public Library is not loaded. 
If anything was written on the Public Library file, the file 
is destroyed and an error diagnostic is output. 

The following conventions concerning other control com- 
mands should be observed when using the PUBLIB command: 

1. The FORE option must be specified on ! OLOAD to de- 
fine the area that the Public Library is to occupy at 
execution time. If the limits of this area are exceeded, 
the Loader aborts. 

2. The FILE option on ! OLOAD must specify the name of 
the Public Library file being created in the Foreground 
area. 



iPUBLIB The PUBLIB control command is used to specify 

the object modules from which the Public Library is to be 
created. The order of the parameters determines the order 
of loading. 

The form of the command is 

/^PUBLIBf"C in P ut y 'T* V. . . / in P ut VI 
[^option/ \ option/ \ option/ 



where option may be 

DEVICE, type [,PACK]1 

FILE ,area, name J-as for ROOT and SEG commands 

OPLB, label 

If there are no input options on the PUBLIB control command, 
the first object module on the GO file will be input. 



3. The TEMP, PUBLIB, GO, and TASKS options are illegal, 
and if used, the Loader will abort with an OLOAD con- 
trol command error. 

4. BOUND should be avoided unless a special debug ver- 
sion of a Public Library is being created. 

5. ROOT, SEG, :ASSIGN, LIB, LCOMMON, RES, and 
COMMON control commands cannot be used in creating 
a Public Library. 

Example: Create Public Library From Specified Module 

/^PUBLIB (FILE,SP,MODULE,10) 



In this example, the Public Library will be created from the 
first 10 object modules in the System Library. 
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PROGRAM FILE 

The Program File contains the root and overlay segments in 
core image format and a one-granule header. The program 
header is locatedat granule and contains information nec- 
essary to run-load the program. 

ROOT SEGMENT 

The root is divided into two parts (see "Core Layout at Execu- 
tion Time" later in this chapter). Part one of the root always 
begins in granule 1 of the Program File, and contains the 
PCB, root code, library code, labeled COMMON, and RES 
area for the root. Part two contains the DCBTAB, INTTAB, 
OVLOAD Table, Loader-created DCBs, and the Temp Stack. 

The Temp Stack is not output on the Program File. Each 
part of the root is written as a continuous string of bytes. 
| There is no restriction on the size of the root. 

OVERLAY SEGMENTS 

Each overlay segment begins on a granule boundary and is 
written on the Program File as a continuous string of bytes. 
The order of segments on the file is unimportant, since the 
granule displacement pointer (in the OVLOAD table) for 
each segment specifically determines its position. Segments 
cannot be longer than 16K words (64K bytes). 



Any external DEF/REF that begins with an M: or F: is de- 
fined to be either a system (M:) DCB or user(F:) DCB. DCBs 
referenced by the program that are not satisfied at the con- 
clusion of the load process are either created or allocated 
by the Loader. Copies of system and FORTRAN DCBs are 
created with their standard system parameters and opera- 
tional label assignments. Space for user DCBs is allocated 
at the rate of seven words per DCB. 

Parameters for user or system DCBs may be defined by either 
[ASSIGN control commands at execution time (for back- 
ground programs only) or :ASSIGN control commands at 
load time. 

The user can create his own DCBs within the source code 
and locate them in any segment of his overlay program. 
However, if the user wishes to change parameters in a DCB 
at execution time via an ! ASSIGN command, he must de- 
clare the DCB as an external definition (with a name that 
begins with an F:) and locate the DCB in the root segment. 
To utilize the FORTRAN 1V-H capability of performing 
I/O by using variables as operational labels, the user can 
specify (on the OLOAD control command) a number of un- 
named DCBs to be allocated by the Loader. The user must 
name and define these DCBs before the program executes; 
either at load time (with :ASSIGN), or execution time 
(with [ASSIGN). 



DCBTAB 



TEMPORARY RAD FILES 



The Loader uses six 
| area of the RAD (X 
overflows, the Load 
modules even though 
calculates the numb- 
granules (for direct 
files and lists this 
formation, the user 
Temp files with an 
program. 



scratch files in the Background Temp 
1 ,X2, . . . ,X6). If one of these files 
er completes the pass over the object 

the load will be aborted. The Loader 
er of records (for sequential files) or 
-access files) required for all scratch 
nformation on the Map. With this in- 
can then allocate the Background 
1ALLOBT command and reload the 



LOADER-GENERATED ITEMS 

All items discussed in the following paragraphs are gener- 
ated by the Loader and located in the root segment of the 
overlay program (see Figure 9 in this chapter for a diagram 
of the core allocation). 



PROGRAM CONTROL BLOCK 

The PCB is built by the Loader and located at the FWA of 
the overlay program area. 

DATA CONTROL BLOCKS 

The Loader automatically includes a copy of the M:SL DCB 
in any program that has overlay segments. (M:SL is used by 
the Monitor SEGLOAD function to read in overlay segments 
at execution time.) 



The DCBTAB table is created by the Loader, and contains the 
EBCDIC name (if any) and absolute core location of each 
Loader-recognized or created DCB in the root of the overlay 
program. The EBCDIC name of an unnamed DCB is inserted 
when the DCB is given a name by either the 1ASSIGN or 
:ASSIGN control command. 



INTTAB 



ie interrupt task table (INTTAB) has a one-byte entry for 
each interrupt task in a foreground program. Space for the 
INTTAB is allocated by the Loader according to the numbe 
of tasks specified on the OLOAD control command. 



Th 
ea 



OVLOAD TABLE 

The OVLOAD table is built by the Loader and contains the 
information necessary for SEGLOAD to read in overlay seg- 
ments at execution time. The OVLOAD table consists of 
one entry for each overlay segment, with a total of eleven 
words per entry. 

TEMP STACK 

The Loader allocates space for the overlay program's Temp 
Stack either according to the number of words specified on 
the OLOAD control command, or by default. The Temp Stack 
is located at the end of part two of the root segment and is 
not output on the Program File (see "Core Layout of User 
Program at Execution" later in this chapter). 



64 Program File/Temporary RAD Files/Loader-Generated Items 



EXTERNAL DEFINITIONS 



SYSTEM AND USER LIBRARIES 



The Loader adds the external DEFs F4:COM and P:END to 
all programs except for Public Libraries. F4:COM is the 
name of FORTRAN'S blank COMMON. The initial size is 
set to zero and changed to the largest size encountered dur- 
ing the load process. If there are no references to F4:COM, 
blank COMMON is allocated with a size of zero. The 
Loader indicates the LWA+1 (including blank COMMON) 
of the loaded overlay program by an external definition, 
P:END. External references to P:END within the overlay 
program will be linked to this definition. 

The external DEF, FPrMBOX, is added to Foreground over- 
lay programs by the Loader only if an area was allocated at 
SYSGEN time. FP:MBOX is the name of the Foreground 
Program's Mailbox. External references to FP:MBOX will 
be linked to this definition. 



LIBRARIES 

The Overlay Loader supplies the capability to search the 
System Library or the User Library in any order. The default 
condition is for the Loader to search and load only from the 
System Library. Control commands and keywords enable the 
user to control more specifically the search and load options. 
Note that an attempt will first be made to satisfy all REFs 
with DEFs from the Public Library, if a Public Library has 
been specified on the OLOAD control command. 

If any unsatisfied primary references exist after loading the 
specified modules for a root or an overlay segment, the 
Loader searches the library or libraries in the specified order 
to satisfy those references. Thus, if an external REF is 
made to a higher level segment, the name should not be the 
same as a library definition. Consider the following: 



If segment 1 contains a primary reference, 9SIN, it will 
normally be satisfied by loading a Library at the completion 
of segment 1. Thus, if the definition 9SIN occurred in seg- 
ment 2, it would be in error (a duplicate definition). The 
loading of 9SIN from the library can be suppressed by using 
the EXCLUDE command. In this case, the forward REF would 
be linked and no duplicate DEF would occur. However, if 
the definition 9SIN occurred in the root, or in the library 
loaded in the root, no search for 9SIN would be made in 
segment 1, and the occurrence of the definition 9SIN in 
segment 2 would be in error. Primary references can occur 
in two ways: as external references in a module, or by list- 
ing the primary references on the INCLUDE control command. 



Cross-references between System and User Libraries are al- 
lowed. However, since each library is searched only once 
per segment, the order of search is important. 

If Library A contains references to be resolved by Library B, 
the search criteria : LIB (A,B)must be specified to guarantee 
cross-reference resolution. If B also contained references 
to A they would not be resolved. (Note that these remarks 
do not apply to cross-references within any single library). 

Generally, the System Library should contain the FORTRAN 
Math and Run-Time Routines and should be independent. 
The User Library is a repository for user subroutines and al- 
ternate Math and Run-Time routines that supersede the same 
routines in the System Library, 

The typical search order would be 



/:LIB (USER,SYSTEM) 



where both libraries are referenced. In this case, all unsat- 
isfied REFs from the User Library would be satisfied (where 
possible) from the System Library. 

ASSEMBLY LANGUAGE 

Library routines may be coded in Symbol, Macro-Symbol, I 
FORTRAN IV, or FORTRAN 1V-H. ' 

ENTRY ADDRESS 

Entry addresses in library routines are ignored. 

SYSTEM AND USER LIBRARIES ON RAD 

The System Library and the User Library on the RAD are 
structurally identical. Each library consists of four files: 

EBCDIC 
MODIR 
DEFREF 
MODULE 

The System Library is located in the System Programs (SP) area 
of the RAD, The User Library is located in the Foreground 
Programs (FP) area of the RAD. 

Only the MODULE file contains the actual binary modules 
of the library. The other files are tables constructed by 
the RAD Editor to facilitate the rapid search of the library 
by the Overlay Loaderwithout actually reading the module. 
The library is structured on the principle that access should 
be as fast as possible, since it is performed frequently during 
an overlay loading procedure. 

The three files: EBCDIC, MODIR, and DEFREF contain 
enough information to determine which modules from the 
actual MODULE File are to be loaded without examining 
these modules directly. All four library files are constructed 
and maintained by the RAD Editor. These short files contain 
coded information about the external definitions and primary 
references for each module in the library. 



Libr 
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CONSTRUCTING AND MAINTAINING LIBRARY 



RELEASING A PUBLIC LIBRARY 



To begin construction of a library, the user allocates the 
EBCDIC, DEFREF, MODIR, and MODULE files with the 
RAD Editor, and then copies the library's binary object 
modules onto the MODULE file. As each module is copied, 
the DEFs and REFs are scanned, and corresponding entries 
are built in the other files by the RAD Editor. Library rou- 
tines may be added or deleted by using the RAD Editor 
:COPY and rDELETE commands. 

PUBLIC LIBRARY 

The Public Library is a file containing a set of reentrant 
subroutines in core image format that can be shared in com- 
mon by all foreground and background programs. The resul- 
tant saving in core can be considerable where a FORTRAN 
library is shared. The Public Library is created from input 
modules or library routines by the Loader (see "Forming a 
Public Library"). The availability of the Public Library is 
determined at execution time. 

CALLING THE PUBLIC LIBRARY 

When a user indicates by the PUBLIB keyword on the OLOAD 
control command that Public Libraries are to be used to sat- 
isfy references, the names are set in the program header for 
the Root Loader, and the Public Library Symbol tables are 
read from the Public Library files and added to the loaded 
program's Symbol table. The Loader will satisfy primary 
external references with Public Library definitions at the 
time the external reference is encountered in the object 
module, not at the end of the segment (as when the other 
libraries are searched). When the Root Loader loads the 
root segment of a program, the header is searched to deter- 
mine if the program contains the name of one or more Public 
Libraries. If so, and one of the named Public Libraries is 
not already in core, the Monitor determines whether Public 
Library space is available. If available, the Root Loader 
reads in the named Public Library or Libraries and the pro- 
gram executes. If the space is not available for all Public 
Libraries referenced, the programwill be neither root loaded 
nor executed. 

Each Public Library file is designated at Public Library cre- 
ation time (see "Forming a Public Library"). All Public Li- 
braries are located in the Foreground Programs area of the RAD. 



If no currently executing program is utilizing a Public 
Library and the space is required to load a foreground pro- 
gram, the space is released. 



FORMING A PUBLIC LIBRARY 

A Public Library is created by using the :PUBLIB control 
command in place of the ROOT and SEG commands, and 
modules may be input and libraries searched and loaded in 
the same manner as for standard loading. Because each Pub- 
lic Library has a unique name, more than one Public Library 
can exist in the system. Although no more than three Pub- 
lic Libraries can be called by any one program, any number 
can be created. 

ROUTINES USED TO FORMA PUBLIC LIBRARY 

All routines used to form a Public Library must be reentrant. 
If the Public Library is to be used by background programs, 
all the routines must use the Temp Stack directly for local 
storage (e. g. , FORTRAN IV Math Library; see" Protection" , 
discussed previously). 

If the Public Library is to be used only by the foreground, 
the method of moving local storage in routines to the 
Temp Stack on reentrance can be employed (e.g., Real- 
Time FORTRAN subroutines and FORTRAN Run-Time Li- 
brary). FORTRAN main routines are not reentrant and 
cannot be used. 

Routines assembled in Symbol (one-pass), or Macro-Symbol 
(two-pass), are acceptable provided the reentrancy re- 
quirements are met. 

No references to COMMON, labeled COMMON, or DSECTs 
are allowed in any Public Library routine. 

Since DCBs in the Public Library could not be assigned and 
might not be reentrant, DCBs will not be allowed in any 
Public Library routine. Note that it is not possible for the 
Loader to warn the user about DCBs that are not named ac- 
cording to the conventions and made externals. 



LIBRARY PROTECTION 

Since the call to a Public Library routine is by a BRANCH 
AND LINK(BAL) operation, the write key of the library 
routine is the same as the write key of the user program. 
Thus, the foreground and Monitor are both protected from 
being destroyed by background use of the Public Library. 
However, because of the write-lock protection, routines 
containing their own local storage (e.g., FORTRAN I/O 
run-time) may not be included in a Public Library that is to 
be called from the background since any attempt by a Pub- 
lic Library routine to write in its own foreground local stor- 
age with a background write key would cause a write-lock 
protection violation. 



The file associated with each Public Library is in the FP 
area. This file contains the actual core image of the Pub- 
lic Library and the corresponding Symbol table used by the 
Loader. The name of the file must correspond to the name 
given with the FILE keyword on the OLOAD control com- 
mand, and the file must be previously allocated in the FP 
area by the user. If loading of the requested modules and 
libraries has been completed and there are no remaining 
unsatisfied primary references, the Loader writes the core 
image and the Symbol table to the file in the FP area. If 
unsatisfied primary references are found, the file in the FP 
area is destroyed. A file name of a previous Public Library 
may be used, but at the risk of obliterating the old file if 
the new one cannot be completed. 
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MAP 

Three types of maps may be output to M:LO following Pass 2 
according to the MAP keyword on the ! OLOAD control com- 
mand: aSHflflfmap, PROGRAM map, or ALL map. If the 
MAP option is not specified, none is output. 

The short map is output when the MAP keyword appears alone. 
It consists of essential information about the overlay structure. 

The PROGRAM Map consists of all elements of the short Map, 
plus all external definitions and control sections contained 
in the input modules (excluding those from Library ROMs). 

The ALL Map consists of all elements of the PROGRAM map 
and includes all definitions and control sections from Library 
ROMs. Atypical PROGRAM map is illustrated in Figure 10. 

In Figure 10, the header keywords have the following 
meaning: 

1 . Program Header Keywords: 

FILE: Area and name of the program file. 

NUMBER OF OVERLAY SEGMENTS: Decimal number, 
excluding root. 

LIMITS: FWA and LWA of the Program area. 

BOUND; Hexadecimal value on which object module 
addresses are bounded. 

BLANK COMMON BASE: FWA of blank COMMON 
with the SIZE specified in decimal words. 

PUBLIC LIBRARIES: Names of the Public Libraries, if 
any, referenced by the program. 

TOTAL FILE SIZE: Number of hexadecimal/decimal 
WORDS output to the program file and the number 
of hexadecimal/decimal GRANULES required for 
the file. 

LIBRARY SIZE: Total number of words loaded from the 
user and/or system libraries, 

PROGRAM ERROR SEVERITY: Set to one if any kind of 
error is encountered; otherwise, set to zero. 



2. Root Header Keywords: 

INPUT: Total number of hexadecimal words in the 
root loaded from the ROMs (excluding the Temp 
Stack). 

LIBRARY: Total number of hexadecimal words in the 
root loaded from the User Library and/or System 
Library. 

TOTAL SIZE: Total number of hexadecimal/decimal 
words in the root (including the Temp Stack). 

PI FWA: FWA of part one of the root. 

PI LWA: LWA + 1 of part one of the root. 

SIZE: Number of hexadecimal words in part one of 
the root. 



P2FWA; FWA of part two of the root. 

P2LWA: LWA + 1 of part two of the root. 

SIZE: Number of hexadecimal words in part two of 
the root, 

OVLOAD: FWA of the OVLOAD table. 

PCB: FWA of the Program Control block (PCB). 

ENTRY: Entry address for the root. 

TSFWA: FWA of the Temp Stack. 

SIZE: Number of decimal words in the root. 

DCBTAB: FWA of the DCBTAB. 

INTTAB: FWA of the INTTAB on zero, if none. 

INSEV: Set to one if the error severity level is set on 
any ROM input for the root; otherwise, it is set to 
zero. 

LDSEV: Set to one if any loading errors were encoun- 
tered on the root; otherwise, it is set to zero. 



3. Segment Header Keyword: 



INPUT: Total number of hexadecimal words in the seg- 
ment loaded from the ROMs, RES, and LCOMMON 
control commands. 

LIBRARY: Total number of hexadecimal words in the 
segment loaded from User and/or System Libraries. 

TOTAL SIZE: Total number of hexadecimal/decimal 
words in the segment. 

FWA: FWA of the segment. 

LWA: LWA + 1 of the segment. 

ENTRY: Entry address of the segment. 

INSEV: Set to one if the error severity level is set on 
any ROM input for the segment; otherwise, it is 
set to zero. 

LDSEV: Set to one if any loading errors were encoun- 
tered for the segment; otherwise, it is set to zero. 

GRAN; The granule number (decimal) on the program 
file where the segment's core image begins. 



4. Control Sections: 



Control sections input from the program ROMs are listed 
with the following information: 



ROM ROM number 



address size 
(hex.) (dec.) 



Control sections input from user and/or system libraries 
are listed with the following information: 

fULIBj Record displacement address size 

ISLIBJ in the MODULE file (hex.) (dec.) 
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DCBs 

The user and system DCBs are listed after the control 
section of the ROOT with the following information: 

fSDCBl (name 1 address 

IUDCbJ lUN NAMED] (hex.) 

DEFs, REFs, and DSECTs 

The externals are listed with the following information: 



u 






- unsatisfied or undefi 


D 


= doubly defined or re 


r Dscr 


- dummy section 


DEF 


- definition 


REF 


- primary reference 


.SREF . 


= secondary reference 


'PL" 


= Public Library 


UL 


= User Library 


SL 


= System Library 


AN 


\. 




= Input Module 



The symbol name in EBCDIC (one to eight 
characters). 



e. If the definition is an address, it is expressed as a 
word address and a byte offset. If the definition is 
a constant, it is expressed asa hexadecimal number 
followed by the letter 'c'. For undefined symbols, 
the address field is blank. 

f. The DSECT size in words (decimal). 



ERROR DIAGNOSTICS 

The Overlay Loader outputs diagnostic messages to M:OC 
and M:LL. Duplication is suppressed if OC and LL are as- 
signed to the same device. 

If an operator response is required, the Loader will call the 
Monitor "WAIT" function. The operator should hit the con- 
sole interrupt and key in one of the following: 

C Continue 

X Abort 

COC Read the corrected command from M:OC and 
continue (used only in response to control 
command errors). 

Note that the Monitor "WAIT" routine aborts if an ! ATTEND 
control command has not been encountered in the job stack. 
The diagnostic messages in Table 14 are output by the Over- 
lay Loader. 



Table 14. Overlay Loader Diagnostics 



Text 


Meaning 


Action 


BACKGROUND TOO SMALL 


User's program cannot be loaded 
in the current size of the back- 
ground. This is a function of 
the number of external symbols 
and forward references that a 
program has, not a function of 
the program length. 


Abort 


BINARY CARD ENCOUNTERED INSTEAD OF CC 


A binary record was encoun- 
tered on the C device instead 
of a control command 


Wait 


BOT ON ( yyndd 

larea,name 


Unexpected beginning-of-tape 
has been encountered on the 
specified device/file. 


Abort 


BUF SMALLER THAN DATA RECORD 
DCB x;xxxxxx 


Specified DCB has been assigned 
to a record size larger than the 
I/O buffer associated with the 
Read request. Either the user 
has assigned incorrectly or the 
Loader has a program error. 


Abort 


CC ERR: DUP NAME IN ITEM xx 


Item number xx on the com- 
mand is a duplicate of a name 
in the symbol table. 


Wait 
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Table 14. Overlay Loader Diagnostics (conr.) 



Text 


Meaning 


Action 


CC ERR: DUP SEG IDENT 


Ident on :SEG command is a 
duplicate of a previous seg- 
ment's ident. 


Wait 


CC ERR: FOLLOWING ITEM xx 


There is an error following item 
xx on the command (e.g., a pa- 
rameter has been omitted, an 
extra parameter has been in- 
cluded, etc.). 


Abort if ! OLOAD 
CC. Wait if any 
other CC. 


CC ERR: ILLEGAL CC SEQUENCE 


Loader commands have been 
ordered incorrectly. 


Wait 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD (PUBL,name) 


Option (PUBLIB, name) was speci- 
fied on lOLOAD and a :PUBLIB 
command has been encountered. 


Abort 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD (TASKS,value) 


Option (TASKS, value) was 
specified on lOLOAD and a 
:PUBLIB command has been 
encountered. 


Abort 


CC ERR: ILLEGAL OPTION FOR PUBLIB LOAD (TEMP,value) 


Option (TEMP, value) was speci- 
fied on lOLOAD and a :PUBLIB 
command has been encountered. 


Abort 


CC ERR: ILL OPCODE IN ITEM xx 


Specified operation code is 
either illegal or unimplemented. 


Wait 


CC ERR: ILL SEG IDENT 


Seg ident on the :MODIFY 
command does not match the 
segment being modified. 


Wait 


CC ERR: ITEM xx 


Item number xx on the command 
is in error. 


Abort if lOLOAD 
CC. Wait if any 
other CC. 


CC ERR: MODIFY OUTSIDE SEG LIMITS 


One of the locations on the 
:MODIFY command is outside 
the limits of the segment. 


Wait 


CC ERR: NEED (FORE,fw a/ lwa) OPTION FOR PUBLIB LOAD 


Option (FORE ,fwa,lwa) was not 
specified on the lOLOAD com- 
mand and a :PUBLIB command 
has been encountered. 


Abort 


CC ERR: SEG IDENT NOT 1ST OPTION 


Segment ident (LINK,identi ) is 
not the first option on the :SEG 
command. 


Wait 


CC ERR: SEGMENTS ORDERED INCORRECTLY 


:SEG commands have been in- 
put in the wrong order. 


Wait 


CC ERR: SPECIFIED AREA FOR PUBLIB LOAD NOT 'FP' 


Option (FILE,area,name) on 
lOLOAD did not specify the 
Foreground Programs area (FP) 
and a :PUBLIB command has 
been encountered. 


Abort 
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Table 14. Overlay Loader Diagnostics (cont.) 



Text 


Meaning 


Action 


CC ERR: STEP OPTION ILLEGAL WITHOUT ATTEND 


An ! ATTEND command must be 
included in the job when the 
STEP option is specified. 


Abort 


CC ERR: UNDEFINED FILE area,name 


Area and file specified in the 
option (FILE, area, name) has not 
been defined by the RAD Editor 


Abort if lOLOAD 
CC. Wait if any 
other CC. 


CC ERR: UNDEFINED SYMBOL IN ITEM xx 


Symbol name in item xx on the 
: MOD I FY command has not 
been defined. 


Wait 


DCB CANN 
SEGxxxxx 


OT BE 

ULIB 
ROM 
SLIB. 


A DSECT 
xxx 


A DCB was encountered in the 
named segment that was as- 
sembled as a dummy section 
instead of being part of the 
control section. 


Abort 


DCB HAS BAD PARAMETERS 
DCB x:xxxxxx 


Specified DCB has bad param- 
eters. Either the user has as- 
signed incorrectly or the Overlay 
Loader has a program error. 


Abort 


DCB HAS INSUFFICIENT INFO 
DCB x;xxxxxx 


Specified DCB contains insuf- 
ficient information to open a 
Read or Write operation. 
Either the user has assigned in- 
correctly or the Loader has a 
program error. 


Abort 


DCB NOT ASSIGNED 
DCB x:xxxxxx 


Specified DCB has been assigned 
to the "null" device. Either the 
user has assigned incorrectly, or 
the Overlay Loader has a pro- 
gram error. 


Abort 


DEFAULT ENTRY ADDRxxxxx SUPPLIED FOR ROOT 


A transfer address was not en- 
countered on any ROM in the 
root and an entry address was 
not specified on the CC; there- 
fore, a default has been supplied. 


Continue 


DSECT'S IN 
SEGxxxxx 


PUBL 

ULIB 
ROM 
SLIB 


IB LOAD 
xxx 


Labeled COMMON blocks 
(DSECTs) are illegal in the 
Public Libraries. 


Abort 


EOT ON | yyndd 

larea,name 


End-of-tape has been encount- 
tered on the specified device/ 

file. 


Wait 


EXLOC TOO LARGE 
SEGxxxxx 


The execution locations of the 
specified segment will exceed 
131K at the given EXLOC. 


Abort 
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Table 14. Overlay Loader 


Diagnostics (cont.) 




Text 


Meaning 


Action 


FILE DESTROYED area,name 


Overlay Loader is aborting past 
the point where data has been 
written on the specified pro- 
gram file. The first sector of 
the file has been zeroed out. 


Abort 


FILE UNCHANGED area,name 


Overlay Loader is aborting at a 
point where the program file is 
unchanged. 


Abort 


ILLEGAL LOAD LOCATION xxxxx 


Specified "load location" origin 
has been defined with a value 


Abort 




ULIB 




that is either not an address or 




SEGxxxxx 


ROW 
SLIB 


xxx 


that lies outside the address limits 
of the specified segment. (A 






labeled COMMON block must 






be initialized in the segment 






where the block is allocated.) 




ILL SEG IDENT TERMINATED MODIFY'S 


The :MODIFY commands have 
been ordered incorrectly for 
the (GO,LINKS) option. The 
MODIFY mode has been termi- 
nated at this point. If the user 
wishes to continue, all :MODIFY 
commands that follow will be 
ignored. 


Wait 


LIB ROM'S EXCEED MAX 


Maximum number of library 


Abort 


SEGxxxxx 


ROMs that can be loaded is 
2000. 




MONITOR CC ENCOUNTERED INSTEAD OF :ROOT or :PUBLIB 


Monitor control command was 
encountered on the C device 
instead of a :ROOT or :PUBLIB 
command. 


Abort 


MOUNT PAPER TAPE ROM 


STEP option was specified on 


Wait. Operator 




IOLOAD and the next relocat- 


should load the paper 




able objectmodule (ROM) is to be 


tape, interrupt, and 




input from the paper tape reader. 


key in "C". 




CCI 




Loader has a program error in 


Abort. Operator 




ONE 




the named overlay at the speci- 


should get a core 


PROGRAM ERR : - 


TWO 
MAP 


•ADDRxxxx 


fied address. 


dump. 




LIB 










[ULIB 








SEGxxxxx 


ROW 
SLIB 


1 xxx 














CCI 




Specified error status has been 


Abort 




ONE 




returned from an Overlay Loader 




PROGRAM ERR:- 


TWO 
MAP 
LIB 


•SB=xx,ADDR xxxx 


call (in the named overlay) to a 
Monitor I/O routine. The ad- 
dress of the CAL and the name 




DCB x:xxxxxx 


of the DCB are specified. 
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Table 14. Overlay Loader Diagnostics (cont. 



Text 


Meaning 


Action 


PROGRAM 
SEGxxxxx 


ERR: UNALLOCATED CSECT 

ULIB] 
ROM xxx 
SLIB J 


Loader has encountered a con- 
trol section that has not been 
allocated; either a Loader, 
compiler, or assembler error. 


Abort 


RAD FILE TABLE FULL 


RAD File Table size that was allo- 
cated atSYSGEN is insufficient. 


Abort 


READING AN OUTPUT DEVICE 
DCB x:xxxxxx 


A DCB that the Overlay Loader 
reads with has been assigned to 
an OUT device. Either the user 
has assigned incorrectly or the 
Loader has a program error. 


Abort 


ROM ERR: 
SEGxxxxx 


BAD S 

ULIB 
ROM 
SLIB 


xxx SEQNOxxx 


Sequence number of the binary 
record does not equal xxx. 


Wait 


ROM ERR: 
SEGxxxxx 


CHKSl 

ULIB 
ROM 
SLIB 


JM 
xxx SEQNOxxx 


Specified binary record has a 
checksum error. 


Wait 


ROM ERR: 
SEGxxxxx 


EXPRESSION SIZE EXCEEDS MAX 

ULIBl 

ROM[xxx SEQNOxxx 

SLIB j 


An object language expression 
on the specified binary record 
exceeds 120 bytes. 


Abort 


ROM ERR: 
SEGxxxxx 


ILLEG 

ULIB 

ROM 
SLIB 


AL LOAD ITEM 
xxx SEQNOxxx 


Object language on specified 
binary record cannot be trans- 
lated (assembler or compiler 
error). 


Abort 


ROM ERR: 
SE G xxxxx 


NOW 

ULIB 
ROM 
SLIB 


ODULE END 
xxx SEQNOxxx 


Module end was not encoun- 
tered on the last binary record 
of the relocatable object 
module. 


Abort 


ROM ERR: 
SEGxxxxx 


NOT OBJECT LANGUAGE 

ULIB] 

ROM [xxx SEQNOxxx 

SLIB J 


Specified binary record is not 
in object language format. 


Wait 


ROM ERR: 
SEGxxxxx 


NOT 

ULIB 
ROM 
SLIB 


STANDARD BIN 
xxx SEQNOxxx 


Specified record has a non- 
standard binary format. 


Wait 


UNDEFINED FILE area,name 
DCB x:xxxxxx 


Specified DCB has been assigned 
to a RAD file that has not been 
defined by the RAD Editor. 


Abort 
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Table 14. Overlay Loader Diagnostics (cont. 



Text 


Meaning 


Action 


UNDEFINEI 
SEGxxxxx 


) ORK 

ULIB 
ROM 
SLIB 


3IN 

XXX 


Loader has encountered a "load 
location" origin with an expres- 
sion that cannot be resolved. 


Abort 


UNEXPECTED EOD ON| y/ndd 

(area, name 


Unexpected !EOD was encoun- 
tered on the specified device/ 
file. 


Wait if the !EOD 
was encountered 
instead of a ROM; 
otherwise, Abort. 


UNEXPECTED MONITOR CC ON( yyndd 

larea,name 


Unexpected Monitor control 
command was encountered 
while reading ROMs from the 
C device. 


Abort 


UNRECOVERABLE RD ERR ON( yyndd 

larea,name 


Transmission error has occurred 
while reading from the speci- 
fied device/file. 


Abort 


UNRECOVERABLE WR ERR ONJ yyndd 

larea,name 


Transmission error has occurred 
while writing on the specified 
device/fiie. 


Abort 


WARNING: 
SEGxxxxx 
DCB x:xxxx 


DCB IN OVERLAY SEGMENT 

ULIB] 

ROM xxx SEQNOxxx 

SLIB ) 

XX 


Specified DCB was declared an 
external DEF in a segment other 
than the Root. The DCB will 
not be included in DCBTAB. 


Continue 


WARNING: DEF'D DCB NOT DEFINED 
DCB x:xxxxxx 


Specified DCB was declared on 
external DEF and the DEF was 
never defined. 


Continue 


WARNING: DUPLICATE DEF'S 


User's program contains dupli- 
cate external DEFs. Map will 
indicate the name(s) of the DEFs. 


Continue 


WARNING: DUPLICATE REF'S 


User's program contains dupli- 
cate external REFs. Map will 
indicate the name(s) of the 
REFs. Occurs when identical 
DEFs in different segments of 
different paths are referenced 
by the same REF (in a segment 
common to both paths). 


Continue 


WARNING: ENTRY ADDRxxxxx OUTSIDE SEGMENT 
SEGxxxxx 


Entry address for the specified 
segment is outside the segment's 
address limits. 


Continue 


WARNING: ILLEGAL DCB ADDR 
DCB x:xxxxxx 


Specified DCB was declared an 
external DEF and the DEF has 
been defined with either a neg- 
ative address or a constant. 


Continue 
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Table 14. Overlay Loader 


Diagnostics (cont.) 




Text 


Meaning 


Action 


WARNING: ILLEGAL DCB NAME 


Specified DCB name is illegal 


Continue 


[ULIBj 
SEGxxxxx JROMfxxx 

ISLIB J 


and will not be included in 




DCBTAB. Monitor DCBs(M:) must 
have standard OPLB names. User 




DCBs(F:)must not exceed eight 




DCB x:xxxxxx 


EBCDIC characters in length. 




WARNING: LCOM name OF SIZE xxxx GREATER THAN 


The named labeled COMMON 


Continue 


ALLOCATED 


block (DSECT) with the size 




SEGxxxxx 


ULIB 
ROM 
SLIB 


xxx SEQNOxxx 


specified in words is greater 
than the size allocated. 




WARNING: NO ENTRY ADDRESS FOR ROOT 


Root does not have an entry 
address. 


Continue 


WARNING: OVERLAY SEG GREATER THAN 16K 


Specified overlay segment ex- 
ceeds the maximum size record 
that can be loaded by the Mon- 
itor SEG LOAD function. 


Continue 


WARNING: PROGRAM EXCEEDS SPECIFIED ADDR LIMITS 


User's program exceeds the ad- 
dress limits, either specified on 
! OLOAD or the defau 1 ts for back- 
g round/foreground programs. 


Continue 


WARNING: UNDEFINED DEF'S 


User's program contains external 
DEFs that either have not been 
defined or have been defined 
with an expression the Loader 
cannot resolve. Map will in- 
dicate the name(s) of the un- 
defined DEFs. 


Continue 


WARNING: UNDEFINED ENTRY ADDR 


Expression defining the entry ad- 


Continue 


SEGxxxxx 


dress for the specified segment 
cannot be resolved by the Loader. 




WARNING: UNSATISFIED REF'S 


User's program contains unsatis- 
fied external REFs. Map will 
indicate the name(s) of the DEFs. 


Continue 


WRITING ON INPUT DEVICE 


A DCB that the Overlay Loader 


Abort 


DCB x:xxxxxx 


writes with has been assigned to 
an IN device. Either the user 
has assigned incorrectly or the 
Loader has a program error. 




yyndd WRITE PROT 


Specified RAD is write- 
protected. 


Wait and 




1. Reset RAD pro- 






tection switches 
or 






2. Interrupt and 






key in "SYC", 






or 






3. Interrupt and 






key in "X" if 






the job is not 






allowed to write 






on protected 






areas of the RAD. 
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USER LOAD-TIME ASSIGNS 

M:DCB AND F:DCB 

DCBs identified by external definitions must exist in the 
root for each unique reference to an M:DCB orF:DCB. 
These are either inserted explicitly by the user or built im- 
plicitly by the Loader. A user can change DCB assignments 
in several ways: 

1 . By modifying the DCB at execution time. 

2. By using a load-time :ASSIGN (foreground and 
background). 

3. By using a run-time !ASSIGN( n9t all o w e d far ei f e ro - i 
rjrnnnrl p n i ijn ii rr^ i ^ , - ■ v x^ c.j?\r •-> • a ■■/■■ <* A '^i'fi -*■>•<" 

RUN-TIME ASSIGNS 

Run-time lASSIGNs (by Job Control Processor) apply only 
I to the background job in which they are inserted. Change 

of assignment for foreground programs is permitted only 
I through STDLB key-ins and load-time :ASSIGNs. 



LOAD-TIME ASSIGNS 

Load-time :ASSIGNs are changes to the respective DCB at 
load-time, so that the given assignment remains as a part of 
the program. This effectively allows assignments for fore- 
ground programs, and assignment of DCBs with nondefault 
cases. 



FORTRAN INTERFACE 

System interface between FORTRAN-produced programs and 
RBM is the shared responsibility of the FORTRAN compiler- 
Loader-RBM complex. This complex enables the user to 
program real-time programs for foreground operation using 
Real-Time FORTRAN language without having to use sym- 
bolic coding to create the system interface (see FORTRAN 
job examples in Chapter 8). 

Symbolic code and control information can be used to give 
the FORTRAN user added versatility in cases where compat- 
ibility with other FORTRAN configurations is not a factor. 
However, such coding is not required. That is, the user can 
write and execute a program to service real-time interrupts 
without any symbolic embellishment of the FORTRAN lan- 
guage and without destroying the real-time response required. 



COMMON ALLOCATION 

BLANK COMMON 

By default, blank COMMON is allocated beginning at the 
end of the longest path as illustrated in Figure 11. 
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F4-.COM 



P:END 



Figure 11. Blank COMMON Allocation by Default 

The size of blank COMMON is determined by the size of 
the largest blank COMMON encountered during the load- 
ing of all segments. 

An optional COMMON control command allows the user to 
specify that the blank COMMON base is to be set immedi- 
ately following that segment, as illustrated in Figure 12. 
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Figure 12. Blank COMMON Option 

Note that in Figure 12, segment 1 sets the COMMON base 
so that segments 1 , 2, and 3, share all COMMON, but seg- 
ment 4 overlays a portion of COMMON. Thus, segments 1 , 
2, and 3, might operate on a large array, leaving the results 
in upper COMMON for segment 4, which can reclaim the 
remainder of the COMMON storage. However, a COMMON 
allocation in segment 4 would be necessary to align refer- 
ences to the upper portion of COMMON. 



LABELED COMMON 

Labeled COMMON is allocated by the Loader either by de- 
fault in the segment in which the block is first encountered, 
or specifically, by the parameters on the LCOMMON con- 
trol command. All references to a labeled COMMON block 
must be in the same path as the definition. Note that la- 
beled COMMON in the root is available to all segments. 
A labeled COMMON block must be initialized in the seg- 
ment that is allocated. 
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The LCOMMON control command will allocate labeled 
COMMON in the segment specified by the preceding SEG 
command. The example 

/^COMMON (A,100),(B,101),(XRAY / 50) 

/:SEG (LINK,201,ONTO,0) 



will allocate a labeled COMMON block /A/of 100 words, 
a block /B/of 101 words, and a block /XRAY/of 50 words 
in segment number 201. 



CONNECT 

The Loader does not provide any facility for generating 
code to connect foreground programs to interrupts or to 
trigger interrupts. The CONNECT statement in FORTRAN 
plus the Monitor CONNECT call provides the necessary 
interface. 



The SEGLOAD function calls in the overlay segment and 
returns, e. g. , 

CALL SEGLOAD (I) 

CALL SUBROUTINE 

where I is the segment ident. 

MAIN PROGRAM NAME AND ENTRY 

The entry point of a FORTRAN main program is not neces- 
sarily the first location of the program. The compiler will 
output an external definition to identify it as a FORTRAN 
main program. The entry point for that program is either 
the transfer address on the main program, or the value spec- 
ified with the ENTRY keyword on the :ROOT command. 

LABELED COMMON NAMES 

Labeled COMMON blocksare identified as DSECTs, labeled 
with an external definition the same as the block name. 



CALLING OVERLAY SEGMENTS 

The Overlay Loader generates no implicit calls for load- 
ing overlay segments, and generates no explicit code for 
such calls. FORTRAN programs to be run in overlay form 
| must call the FORTRAN run-time routine SEGLOAD, which 
calls the SEGLOAD function of the Monitor. The iden- 
tification numbers in the argument list must correspond to 
the identification number on the SEG control command. 



BLANK COMMON NAMES 

Blank COMMON references are identified as DSECTs with 
the unique external definition name F4:COM. 

CORE LAYOUT AT EXECUTION TIME 

The core storage area allocations for a typical segmented 
program are illustrated in Figure 13. 
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Optional Space for BOUND 



Root Code (User Programs) 



Root Library Programs 



LCOMMON (root only) 
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SEG1 



SEG2 
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SEG4 
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OVLOAD Table 



Loader Created DCBs 
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SEG 5 
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LWA+ 1 of Program (P : END) 



Figure 13. Standard Core Layout of a Program 
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7. RAD EDITOR 



The RAD Editor is a background processor that performs RAD 
allocation for RAD areas by generating and maintaining di- 
rectories for all permanent files. Through commands input 
by the user, the RAD Editor performs the following functions: 

• Adds or deletes entries to the permanent file directories 
that, in turn, allocate and release permanent RAD space 
within a RAD area. 

• Copies data files onto the RAD. 

• Appends records to the end of an existing RAD file. 

• Compacts permanent file directories and permanent 
RAD areas. 

• Truncates empty space from the end of RAD files. 

• Maps permanent RAD file allocation. 

• Dumps the contents of RAD files or entire RAD areas. 

• Copies permanent RAD files. 

• Copies object modules contained in the libraries. 

• Saves the contents of RAD areas on a magnetic or paper 
tape device in a self-reloadable form. 

• Restores previously saved RAD areas to their RAD 
location. 

• Maintains library files on RAD for use by the Overlay 
Loader. 

• Zeros out (clears) complete RAD areas. 

• Temporarily inhibits the use of bad tracks on the RAD. 

OPERATING CHARACTERISTICS 

FILE ALLOCATION 

The RAD Editor performs RAD allocation for all permanent 
files. The name, size, and location of each permanent RAD 
area are indicated through the use of a Master Directory that 
is set up at system initialization in the resident portion of 
RBM. The permanent RAD areas maintained by the RAD 
Editor are 

Background programs (BP). 

Data (Dl-DF). A maximum of 15 Background and 
Foreground data areas are allowed. 

Foreground programs (FP) contain User Library. 

System programs (SP) contain System Library. 



The Editor controls file allocation by generating and main- 
taining a directory entry for each file within the above per- 
manent RAD areas. Every permanent RAD area has a direc- 
tory that begins in the first sector of its own area. A direc- 
tory consists of entries with the following information: 

• File name (maximum length of eight alphanumeric 
characters). 

• Resident foreground program flag. 

• File type; blocked; unblocked, or compressed. 

• Granule size in bytes (used for direct access). 

• File size (current number of records in file). 

• Record size (bytes per logical record). 

• Relative RAD address of the first sector defined for 
the file. 

• Relative RAD address of the last sector defined for 
the file. 

Before any permanent RAD file can be written, space must 
be allocated for the file by requesting the RAD Editor to add 
a new entry to the designated directory. Directory entries 
may be added or deleted by using RAD Editor commands. 
The following method is used to allocate files: 

1. Permanent RAD files are allocated sequentially, begin- 
ning in the second sector of the area, with every file 
beginning and ending on a sector boundary. 

2. A new directory entry is added as the last entry to the 
existing directory and the corresponding space for the 
file is allocated. 

3. When all available space in an area is exhausted, a 
complete search of the file directory is made for un- 
allocated areas made available through file deletions. 
The smallest area containing a sufficient amount of 
space to allocate for the file is selected. If sufficient 
space is not found upon searching the directory, the op- 
eration is aborted. To overcome this problem, RAD 
squeezing may be requested to recover the unused stor- 
age within a permanent RAD area by compressing the 
directory entries and files (see Figures 14 and 15). | 

4. File deletion is accomplished by zeroing out theappro- 
priate directory entry. 



SKIPPING BAD TRACKS 

The method used to handle bad RAD tracks is as follows. 
The :BDTRACK command removes the track from use by 
placing a special entry in the file directory and allocating 
the track as a file. The :GDTRACK command returns the 



80 



RAD Editor 















Identification entry 






File 1 directory entry 




File 1 




Deleted directory entry 


Unallocated 


File 2 directory entry 


File 2 


Deleted directory entry 


Unallocated 


Bad track directory entry 


Bad track 


File 3 


File 3 













Figure 14. Permanent RAD Area Before Squeezing 
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The RAD Editor is the only processor that should write in the 
library files. The files are generated from information con- 
tained in the object modules read in by the RAD Editor. Each 
module is identified within the library files by a DEF. The 
first DEF encountered in the module is considered the module 
name, and no other DEF in a program will be so recognized. 
Any module may be referenced by using the first DEF in a 
program, and modules may be copied or deleted through its 
use. 



ALGORITHMS FOR COMPUTING LIBRARY FILE SIZES 



The following algorithms can be used to determine the ap- 
proximate sizes of the four files in a library. It is not crucial 
that the file sizes be exact, since any unused space can be 
recovered via the :TRUNCATE command. The approximate 
number of sectors (n. Ar>tr ., D ) required in the MODIR file is 



3(1) 



MODIR 



vhere 



i is the number of modules to be placed in the 

library. 

s is the RAD sector size in words. 

3 words is the length of a MODIR file entry. 

The approximate number of sectors (n_ D -_._) required in 
the EBCDIC file is EBCDIC 



Figure 15. Permanent RAD Area After Squeezing 



_ 2(d) 



EBCDIC 



track for RAD Editor use by deleting the file directory entry. 
When a bad track is discovered, it it the user'sresponsibility 
to prevent it from being used by deleting the defective file 
and reallocating an area for the new file if it is to be 
regenerated. 



SYSTEM AND USER LIBRARY FILES 



System and User Library files are searched by the Overlay 
Loader to satisfy external references. These files are gen- 
erated and maintained by the RAD Editor in a form that can 
be rapidly and easily searched by the Overlay Loader. The 
System Library files must reside in the System Programs (SP) 
area, and the User Library files must reside in the Fore- 
ground Programs (FP) area. Each library consists of three 
unblocked files: the Module Directory File (MODIR), 
DEFREF File (DEFREF), and EBCDIC File (EBCDIC); and 
one blocked file: Module File (MODULE). The user must 
define and allocate these library files via the RAD Editor 
by using the file names that appear within parentheses above 
and defining the files as blocked or unblocked. As an aid 
in approximating the file sizes, the user can use the algo- 
rithms given below. 



d is the unique number of DEFs in the library. 

s is the RAD sector size in words. 

2 words is the average length of an EBCDIC file 

entry. 



The number of records (n. .->_,.._ ) required in the MODULE 
.... . MUDULt 

tile is 



MODULE 



£ c, 



where 



n is the total number of modules in the library. 

C. is the number of card images in the ith library 

routine. 
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The number of sectors (r>_ c _ DC _) in the DEFREF file is 
DcrKbr 

n d. + r. 

E , + -V 



i = 1 



DEFREF 



n is the total number of routines in the library, 

d is the number of DEFs in the ith library routine, 

r is the number of REFs in the ith library routine, 

s is the RAD sector size in words. 

RAD AREAS PROTECTION 

Updating or squeezing of permanent RAD areas containing 
information for real-time programs (foreground programand 
foreground data areas) must not occur while the foreground 
is utilizing these permanent RAD areas. The user must 
ensure that the RAD Editor is not modifying a permanent 
RAD area at the same time a foreground program is using it. 

Software protection of the SP, FP, BP, and foreground data 
areas of the RAD is provided by requiring the operator to 
key in "5Y" before any of these areas are modified by a 
background processor. The only areas that can be modified 
that do not require a SY key-in are the Background Data areas. 



CALLING RAD EDITOR 

When a 1RADEDIT control command is read from the C de- 
vice, the RAD Editor is loaded into core memory from the 
RAD. Control is transferred to the RAD Editor which reads 
commands from the C device that specify the functions to 
be performed. 



The form of the command is 
/iRADEDIT 



The RAD Editor is terminated when a record with an ! in 
column one is read from the C device (with the exception 
of !EOD). An !EOD indicates an end-of-data to the RAD 
Editor when data is input via the :COPY command. 



COMMAND FORMATS 

All RAD Editor commands are input from the C device and 
listed on LL. The general form for RAD Editor commands 
is identical to the RBM control command format described 
in Chapter 2, with the symbols below being used to aid in 
describing the RAD Editor commands in this chapter. 



aa refers to a permanent RAD area and must be one | 

of the fol lowing: 

BP is the Background Programs area. 

Dl through DF is the Background and 

Foreground Data areas. 

FP is the Foreground Programs area. 

SP is the System Programs area. 

zz refers to any RAD area. ' 

nnnnnnnn refers to a file name or library module 

(maximum name length of eight alphanumeric 
characters). 

yyndd refers to a physical device name, where 

yy specifies the type of device: CR, CP, etc. 

n specifies the IOP number: A for IOPO, 

B for IOP1, etc. 

dd specifies the device number: 03, 80, etc. 

OP refers to an operational label: BI, SI, etc. 

RAD EDITOR COMMANDS 

: ALLOT The :ALLOT command adds a new entry to the 

specified permanent file directory that allocates space for 
a new file. After space has been allocated, files can be 
written by either background or foreground programs. The 
space allocated for the new entry is zeroed out. 

The form of the command is 

/ :ALLOT (FILE, aa, nnnnnnnn) [, (option)] . . .[, (option)] J 



where the options are 

FORMAT, type specifies the file format where type is | 

U for unblocked. 

B for blocked. 

C for a compressed file. 

The default value is unblocked. 

FSIZE, value specifies the decimal length of the 

file in logical records. The defaultvalue is 1000. 

RSIZE, value specifies the decimal number of words 

per record. The logical record size is used in se- 
quentially accessing a file. For a compressed file, 
record size is omitted and the Monitor blocks com- 
pressed files into 256-word records. Blocked files 
have a default value equal to 128 words per record. 



If this file name is RBM and in the SP area, it cannot be 
copied or dumped. 
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If the record size is greater than 128 words, un- 
blocked organization will be given. Unblocked 
files have a default record size equal to the gran- 
ule size. 

GSIZE, value specifies granule size in words and is 

used for direct access only. The default size will 
be equal to the RAD sector size. 

RF indicates that the file contains a resident fore- 

ground program and is applicable only if the FP 
area is specified. If RF is omitted, the file does 
not contain a resident foreground program. Any 
program flagged as resident foreground will be 
automatically loaded into core every time the sys- 
tem is booted from the RAD. 

Examples: 

1. An unblocked file: 



:ALLOT (FILE,BP,TEST), (FORMAT,U), (FSIZE,50), 



3 



(RSIZE, 90) 



This example allocates space for the unblocked file 
TEST in the BP area of the RAD, with a file size of 
50 records and a record size of ?0 words. 

2. A blocked file: 

:ALLOT (FILE,FP,TESTA), (FORMA T,B),(FSIZE,50), 



LZ 



: 



(RSIZE, 30), RF 



This example allocates space for the blocked file 
TESTA in the FP area, with a record size of 30 words 
and a file size of 50 records. This is a resident fore- 
ground program. 

:C0PY The :COPY command copies single files of data 

or modules (EBCDIC, BINARY in standard binary format, or 
nonstandard binary) from one device to another. Input and 
output must be copied to and/or from the RAD. Files are 
copied until an ! EOD or tape mark is encountered, except 
when the CC option is specified, which is terminated when 
an :EOD is encountered. A logical file mark will be writ- 
ten onto the output file. 

On 7-track tape, a copy from a file to a device assigned to 
an op label will be in packed binary format. If a device is 
specified, the information (data) will be written unpacked. 

When nonstandard binary (BIN) or control commands (CC) 
are copied from the C device, the C device must be assigned 
to and reassigned after the copy is completed. The as- 
signment is made when the message 

1IKEYEN STDLBC,0 
is typed to the operator and reassigned when the message 

1ICOPY ENDED 
appears. 



An IATTEND card must be used to force a pause for oper- 
ator intervention whenever the BIN and CC options are 
specified. 

The general form of the command is 



:COPY < 



FROM 

FILE,aa,nnnnnnnn 
LIB,aa,nnnnnnnn 

IN 'f 0P HHJ 
yynddf 




TO. 

FILE, aa, nnnnnnnn 
LIB,aa 



OUT, 



'lyyndd) 



L [,VFC] [, ADD] [,BIN] [,CC] [,FBCD] 



whe 



FILE indicates either a file in a permanent RAD area, 

a file in the Background Temp area where nnnnnnnn 
is the designated file, or the Checkpoint of IOEX 
access area where nnnnnnnn is not applicable. 
Areas CK and XA are only allowed as input files. 

LIB indicates a library object module(s) in the SP or 

FP area. 

IN indicates an input operation from a non-RAD 

device is to be performed. 

OUT indicates an output operation to a non-RAD 

device is to be performed. 

VFC indicates vertical format control is desired on 

printing. 

ADD indicates records are to be added to the end 

of an already existing file. 

BIN specifies that nonstandard binary information 

is to be copied from the card reader or to the card 
punch. 

CC specifies that control commands are to be 

copied from the C device. 

FBCD specifies that BCD input is to be converted 

to EBCDIC. 

The following are examples and explanations of the differ- 
ent types of copies that can be performed. 



Examples: 
' :COPY 



h w 



,(FILE,aa,nnnnnnnn) 



This example copies a file of data onto the specified RAD 
file. 
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:COPY(iN, l° P ndd ]) ,(FILE,aa, nnnnnnnn), CC 



This example copies a file of data containing control com- 
mands from the C device onto the specified RAD file, 

:COPYAN, | 0p \\ , (FILE, aa, nnnnnnnn),ADD 



:COPY (FILE,aa,nnnnnnnn), 



MW) 



This example copies the contents of the specified RAD file 
onto the specified device. 



:COPY (FILE,aa,nnnnnn), 



(° UT '("n4- B ' N 



This example adds data to the end of an already existing 
RAD file. 



This example copies nonstandard binary from the specified 
RAD file to the card punch. 



:COPY ( IN '(:yndd})'( LIB ' 



:0PY ( FILE,aa),(0UT,{°P ndd }) 



This example copies the library object modules to the speci 
fied library. The library being copied will completely re- 
place an already existing library. 



:COPY ( IN ' |yyndd})< LIB '° a >' ADD 



This example adds the library object modules to the speci 
fied library. 

/ 

:COPY (FILE,aa,nnnnnnnn),(FILE,aa,nnnnnnnn) 



This example copies the contents of the first specified RAD 
file to the second specified RAD file. 

:COPY (LIB,aa,nnnnnnnn), (oUtJ° P \\ 



This example copies one library object module to the speci- 
fied output device. The "nnnnnnnn" parameter is the name 
of the library object module to be copied. 



:COPY (FILE,aa,nnnnnnnn), (°UT,J OP ndd ]\ ,VFC 



This example lists the contents of an EBCDIC file with ver- 
tical format control. 



This example copies the contents of the IOEX access (XA) 
or Checkpoint (CK) areas to the specified output device. 

:DELETE The :DELETE command deletes either a file di- 

rectory entry and file from a specified permanent RAD area, 
or an object module from the designated library. The space 
formerly allocated is not used until a :SQUEEZE is executed. 

The :DELETE command has the form 



:DELETE(j p| , aa, nnnnnnnn I 



Examples: 

1. Delete a file: 



:DELETE (FILE, BP, TESTA) 



2. Delete an object module: 



:DELETE (LIB,SP,CSCN) 



This example specifies that an object module named 
CSCN is to be deleted from the Library in the SP area. 

iCLEAR The :CLEAR command zeros out the specified 

RAD areas which results in deleting all files and file direc- 
tories in the area. 



84 RAD Editor Commands 



The form of the command is 



/•CLEAR zz,zz, . . . 



I where zz is any RAD area. 
Example: 
/:CLEAR D1,DF 



This example specifies that permenent RAD areas Dl and DF 
are to be zeroed out. 

iSQUEEZE The :SQUEEZE command regains unused space 

within permanent RAD areas resulting from file deletions and 
truncations and library module deletions. Unused space is 
regained by compressing file directory entries and their as- 
sociated files, and library file entries and their associated 
library modules. Within the libraries, the Module Directory 
File (MODIR) and the Module File (MODULE) entries and 
modules are compressed to regain the unused space. Space 
is regained in the remaining two files, EBCDIC File (EBCDIC) 
and DEFREF File (DEFREF), by regenerating them completely 
from the Module Directory and Module Files. 

The forms of the command are 



:SQUEEZE aa,aa,aa, . 



2. 



rSQUEEZE ALL 



Examples: 

1. Regain unused space in specified area: 
/^SQUEEZE SP 



This example regains unused space between files and 
between modules in the SP area only. 

2. Regain space in all permanent RAD areas. 



XSQUEEZE ALL 



This example regains unused space between all files 
and modules in all permanent RAD areas. 



iTRUNCATE The :TRUNCATE command is used to trun- 

cate empty space from the end of specified file(s). If the 
allocated RAD space for a file is greater than the actual 
length of the file, a considerable amount of space may be 
left empty. This command will set the allocated space equal 
to the actual length of the file. For a direct access file, the 
length of the file in granules must be specified (g) as actual 
file length is unknown. 

The forms of the command are 



:TRUNCATE (FILE,aa,nnnnnnnn), 
— (FILE,aa,nnnnnnnn). . . ,(FILE,aa,nnnnnnnn) 



Zl 



:TRUNCATE (FILE,aa,nnnnnnnn,g), 



3 



*— (FILE,aa,nnnnnnnn,g). . . ,(FILE,aa,nnnnnnnn,g) 



3. 



:TRUNCATE aa,aa,aa, . . . 



Examples: 

1. Truncate allocated file: 



:TRUNCATE (FILE,BP,TEST) 



This example truncates empty space from the end of the 
allocated file TEST in the BP area by setting the allo- 
cated size equal to the actual size of the file. 

Truncate all files: 



:TRUNCATE BP,D2,D3 



This example truncates all files in the BP, D2, and D3 
areas. 

iMAP The :MAP command maps the specified permanent 

RAD areas to the LO device (using the M:LO DCB). The 
map contains 

1. Information from the Master Directory, consisting of 
the RAD, write protection, area identification, and 
its beginning and ending RAD addresses. 

2. Information from the Permanent File Directories con- 
cerning each file in the area; file name, format. 
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beginning file address, ending file address, file size, 
record size, granule size, and resident foreground pro- 
gram indicator. 

3. Information about object modules in the library files, 
consisting of the name of each module, its relocatable 
length, and the definitions and references in the module. 

The forms of the command are 



:MAP aa,aa,aa, . . . 



2. 



:MAP ALL 



Examples: 

1. Map specified permanent RAD areas: 



:MAP BP,D4 



This example outputs a map of the permanent RAD 
areas BP and D4 to the LO device. 



2. Map all permanent RAD areas: 



/:MAP ALL 



This example outputs a map of all permanent RAD areas 
to the LO device. 

An example of an ALL version of a RAD map (fore- 
shortened for brevity) is illustrated in Figure 16. 

:DUMP The :DUMP command dumps, in hexadecimal, 

the designated random or sequential access file onto the 
LO device (using the M:LO DCB). All permanent RAD 
areas plus the IOEX Access area (XA), Background Temp 
area (BT), and Checkpoint area (CK) can be dumped. The 
RAD Editor will sequentially access the designated file or 
area to be dumped. 

The forms of the command are 



:DUMP (FILE,aa,nnnnnnnn) [,(SREC, value)] 



L7 



[, (E RE C, value)] 



aa also includes the XA, BT and CK RAD areas, and 
nnnnnnnn is any of the files. 

SREC, value specifies the starting record (in deci- 

mal) to begin the dump. 

EREC, value specifies the last record to be dumped. 



:DUMP zz[,(SREC, value)] [, (EREC, value)] 



zz is any RAD area. 

SREC, value specifies the starting sector (in 

decimal) to begin the dump. 

EREC, value specifies the last sector to be 

dumped. 



:xamples 



1. Dump specified fi le: 

X:DUMP (FILE,BP,TEST) 



This example specifies that the TEST file in the BParea 
is to be dumped onto the LO device. 

2. Dump specified records: 

/:DUMP (FILE,BP,TEST),(SREC,10), (EREC,20) 



This example specifies that records 10 through 20 of 
the TEST file in the BP area are to be dumped onto 
the LO device. 

3. Dump specified sectors: 

/:DUMP BP,(SREC,6),(EREC,9) 



This example specifies that sectors 6 through 9 of the 
BP area are to be dumped onto the LO device. 



4. Dump all of specified RAD area: 
/:DUMP BP 



This example specifies that all of the BP area is to be 
dumped onto the LO device. 
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Figure 16. ALL Map Example 



RAD Editor Commands 



87 



:SAVE The :5AVE command saves the specified RAD 

area(s) on the BO device (using the M:BO DCB) for subse- 
quent restoration. The BO device must be either a magnetic- 
tape or paper-tape device. The image of the designated RAD 
area(s) and the RBM bootstrap are written on BO in self- 
reloadable format. The BO output contains a bootstrap loader, 
followed by the RAD image of the RBM bootstrap, and the 
designated area(s). Sectors containing all zeros are sup- 
pressed. Executing the bootstrap loader causes the RAD 
image to be read into memory and restored onto the RAD(s) 
without RBM control. The BO output can also be used to 
restore the RAD via the :RESTORE command. If the BO de- 
vice is a magnetic tape, the tape is rewound and the data 
saved is verified. If the BO device is a paper tape, the 
paper tape must be input on the BI device for verification. 
If the tape verifies correctly, the message 

'SAVE TAPE OK' 

is output. 

The forms of the command are 



:SAVE 



where zz can be any RAD area. 



:SAVE ALL 



where ALL includes all RAD areas except Background, 
Temporary, and Checkpoint. 

Examples: 

1. Dump specified areas to secondary storage: 

X:SAVE SP,BP,D2 



This example specifies that RAD areas SP, BP, and D2, 
with a preceding bootstrap loader, are to be saved on 
the BO device for subsequent reloading. 



2. Dump all RAD areas to secondary storage: 
/:SAVE ALL 



This example specifies that all RAD areas, with a pre- 
ceding bootstrap, are to be saved on the BO device for 
subsequent reloading. 



iRESTORE The :RESTORE command restores the specified 

permanent RAD areas that were saved by the :SAVE command. 
Input is read from the BI device (using the M:BI DCB), and 
the bootstrap is ignored. Read after write is employed to 
verify the data restored. 

The form of the command is 

:RE5TORE zz,zz,... 



Example: 
/RESTORE SP,BP,D2 



This example specifies that the RAD areas SP, BP, and D2 
(previously saved with a :SAVE directive) are to be restored. 

IBDTRACK The :BDTRACK command specifies the RAD 

and the hexadecimal track numbers that are not to be used 
by the RAD Editor. A track containing a sector of the file 
directory is not permitted to be removed from use. 



The form of the command is 

A 



:BDTRACK yyndd, number [,number] . . . 



Example: 



:BDTRACK DCAFO,10, 11 



This example specifies that the RAD Editor is to be inhibited 
from using tracks 10 and 11 on the RAD DCAFO. 

:GDTRACK The :GDTRACK command specifies the RAD 

and the hexadecimal track numbers that now can be used by 
the RAD Editor. The tracks were previously removed from 
use by the :BDTRACK command. 



The form of the command is 

A 



:GDTRACK yyndd, numberf, number]. . . 



Example: 



GDTRACK DCAF0,10,11 



This example specifies that previously inhibited tracks 10 
and 11 are to be restored for use by the RAD Editor. 
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ERROR MESSAGES 

The RAD Editor outputs error messages on the OC and LL 
devices. If OC and LL are assigned to the same device, 
duplication of messages on LL is suppressed. If an operator 
response is required, the RAD Editor will call the Monitor 
"WAIT" routine. The operator initiates a console interrupt 
and keys in one of the following commands to the Monitor. 

C Continue and read next record from the C device. 

X Abort RAD Editor and return control to Monitor. 

COC Continue and read a record from the OC de- 

vice (used only in conjunction with the error mes- 
sage "ERROR ITEM xx"). 



If the Editor aborts because of an irrecoverable I/O error, 
the physical device name is included in the abort message. 

The error messages output by the RAD Editor and their mean- 
ings are given in Table 15. 



RAD RESTORATION MESSAGES 

The messages itemized in Table 16 are written on the 
keyboard/printer during RAD restoration via the bootstrap 
loader produced by SAVE. Unless otherwise specified, the 
computer will go into a WAIT after writing a message. 



Table 15. RAD Editor Error Messages 



Message 


Meaning 


Action Taken 


AREA xx CANNOT CONTAIN 
A RESIDENT FOREGROUND 
PROGRAM 


Illegal area specified. Only the FP 
area can contain a resident foreground 
program 


Operation is aborted. 


AREA xx CKSM ERROR 


A checksum error exists on the RAD 
SAVE tape in the specified area. 


Operation is aborted. 


AREA xx CONTAINS NO 
FILES 


Specified area contains no files. 


Editor continues. 


AREA xx INCOMPATIBILITY 


Attempting to restore specified area 
onto a different type of RAD from 
which it was saved, or the area to be 
restored is too large for the same area 
using the current Master Directory. 


Operation is aborted. 


AREA xx IS NOT ALLOCATED 


Specified area was not allocated at 
SYSGEN. 


Operation is aborted. 


AREA SPECIFIED DOES NOT 
CONTAIN A LIBRARY 


An area other than SP or FP was speci- 
fied that does not contain a library. 


Operation is aborted. 


AREA SPECIFIED IS NOT 
MAINTAINED BY THE RAD 
EDITOR 


An attempt has been made to use area 
CK, XA, or BT which Is not maintained 
by the RAD Editor. 


Operation is aborted. 


AREA xx TRUNCATED 


Specified area being restored is larger 
than the same area using the current 
Master Directory, but the data that was 
lost contained all zeros. 


Operation continues. 


BUFFER SMALLER THAN 
DATA READ 


Data read exceeds the amount of avail- 
able buffer space. 


Operation is aborted. 


CKSM ERR ON SAVE 
TAPE 


A checksum error has been encoun- 
tered while verifying the RAD SAVE 
tape. 


Operation is aborted. 
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Table 15. RAD Editor Error Messages (cont. ) 



Message 


Meaning 


Action Taken 


CKSM ERROR 


Last record in the object module 
being read has a checksum error. 


If the operator response is C, the 
Editor reads the next record from the 
specified device. 


DUPLICATE DEF xxxxxxxx 


Relocatable Object Module being 
copied to the library contains dup- 
licate definitions. 


RAD Editor skips to the end of the 
module. A key-in of C causes the 
Editor to read the next record from 
the specified device. 


DUPLICATE FILE 


An attempt has been made to allocate 
a file using a name which already 
exists. 


Operation is aborted. 


EOT on f yyndd 

[area, name 


Unexpected end-of-tape was encoun- 
tered on the specified device or file. 


Operation was aborted 


ERROR ITEM xx 


Item number xx on the command is 
in error. 


If the operator response is C, the 
Editor reads the next record from 
the C device. If the operator 
response is COC, the next record 
is read from the OC device. This 
will enable operator to rectify a 
directive error. 


FILE xxxxxxxx WAS NOT 
TRUNCATED. FSIZE = 


File was not truncated because file 
size being suggests either a direct 
access file or a file with records. 


Editor continues 


ILLEGAL BINARY RECORD 


An illegal binary record (first byte 
not X'lC, X'3C) has been read 
with an object module. 


If the operator response is C, the 
Editor reads the next record from the 
specified device. 


ILLEGAL FILE NAME 


An attempt has been made to allocate 
a file using GO, OV, or XI -X9 as a 
file name. 


Operation is aborted. 


ILLEGAL LOAD ITEM xx 


Relocatable Object Module to the 
library contains an illegal load 
item. 


RAD Editor skips to the end of the 
module. A key-in of C causes the 
Editor to read the next record from 
the specified device. 


ILLEGAL OPTION xxx 


Option specified is not permitted on 
a :COPY command. 


Operation is aborted. 


ILLEGAL USE OF :COPY 


The specified combination of input 
and output devices on the :COPY 
command is prohibited. 


Operation is aborted. 


INVALID RSIZE. UNBLOCKED 
ORGANIZATION GIVEN 


Maximum record size for a blocked 
file has been exceeded. Unblocked 
orgnization given. 


Editor continues. 


KEY ERR 


Operator key-in is erroneous. 


Key-in has to be either C, COC, 
orX. 


NOT ENUF BACKG SPACE 


Insufficient background space to 
perform the requested operation. 


Operation is aborted. 
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Table 15. RAD Editor Error Messages (cont. ) 



Message 


Meaning 


Action Taken 


RAD OVERFLOW 


Allocating the amount of RAD storage 
indicated by the "file" parameter on 
the :ALLOT command would cause the 
permanent RAD area indicated by the 
"directory" parameter to overflow. 


Operation is aborted. 


RECORD SIZES DIFFER ON 
INPUT AND OUTPUT FILES 


Record sizes differ on copying from RAD 
file to RAD file. 


Operation is aborted. 


REFERENCES TO F4:COM 
NOT ALLOWED 


An external definition or reference 
F4:COM encountered in a Relocatable 
Object Module being copied to the 
library. 


RAD Editor skips to the end of the 
module. A key-in of C causes the 
Editor to read the next record from 
the specified device. 


ROM DOES NOT CONTAIN 
A DEF 


Relocatable Object Module being 
copied does not contain an external 
definition. 


A key-in of C causes the Editor to 
read the next record from the speci- 
fied device. 


SAVE TAPE OK 


RAD SAVE tape has been verified 
correctly. 


No action. 


SEQ ERROR 


Last record in the object module 
being read has a sequence error. 


If the operator response is C, the 
Editor reads the next record from 
the specified device. 


SPECIFIED FILE DOES 
NOT EXIST 


File does not exist within the speci- 
fied area. 


Operation is aborted. 


SPECIFIED ROM DOES NOT 
EXIST 


Relocatable Object Module does not 
exist within the specified library. 


Operation is aborted. 


SREC VALUE GREATER THAN 
EREC VALUE 


Parameter error on the : DUMP com- 
mand. The last record to be dumped 
precedes the initial record to be 
dumped. 


Operation is aborted. 


TRACT xxxxx CANNOT BE 
DELETED 


Illegal attempt to remove a track from 
use containing a sector of the file 
directory. Removal would prevent 
accessing of files or other sectors of 
the directory. 


Operation is aborted. 


UNABLE TO FIND AREA xx 


Specified area cannot be found on the 
RAD SAVE tape during a :RESTORE 
operation. 


Operation is aborted. 


yyndd WRT PROT 


Specified RAD is write-protected. 


Operator should take appropriate 
action: interrupt and key in "SYC" 
or reset the appropriate RAD pro- 
tection switches. Or, if the job is 
not allowed to write on protected 
areas of the RAD, interrupt and key 
in "X" to abort. 



Error Messages 



91 



Table 16. RAD Restoration Messages 



Message 


Meaning 


Resulting Action 


CKSM ERROR 


A checksum error has occurred in 
reading the SAVE tape. 


If the WAIT condition is cleared, the 
bootstrap loader continues and accepts 
the bad record. 


RAD RESTORED OK 


The RAD restoration has been suc- 
cessfully completed. 


Control is transferred from the RAD 
bootstrap. 


TRK = xxxx 

DATA = ALL ZEROS 


Specifies the contents of the RAD 
controller address register in hexa- 
decimal at the time of a check write 
error. 


If the data being written contains all 
zeros, this information is output. If 
the WAIT condition is cleared, the 
bootstrap loader continues. 


yyndd ERROR, 
SB = xxxx 


A parity or transmission error has oc- 
curred on device yyndd. Both the device 
status byte and operational status byte 
are displayed following "SB=", 


There is no recovery. 


yyndd UNRECOG., 
SB = xxxx 


An unrecognized status has been re- 
turned from the indicated device. Both 
the device status byte and operational 
status byte are displayed following "SB=". 


Upon clearing the WAIT condition, 
the operation is retried. 


yyndd UNUS. END, 
TDV = xxxx 


An unusual end status has been returned 
from the specified device. Both the TDV 
status byte and operational status byte 
are displayed following "SB=". 


There is no recovery on a read op- 
eration. On a write operation, the 
write is tried again after the WAIT is 
cleared. 


yyndd WRT PROT 


The RAD is write-protected. 


Program will attempt the RAD write 
after an SY key-in. 
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8. PREPARING THE PROGRAM DECK 



The following examples show some of the ways program 
decks may be prepared for RBM operation. Unless stated 
otherwise, standard default cases for device assignments 
are assumed. 



ASSEMBLE FROM COMPRESSED DECK WITH SOURCE 
AND UPDATES, LISTING OUTPUT 



MACRO-SYMBOL EXAMPLES 

ASSEMBLE SOURCE PROGRAM, LISTING OUTPUT 

Next Command 



Source Deck 



1MACRSYMSLLO 



IJOB 



In this example, the symbolic input is received from the SI 
device and the listing output is produced on the LOdevice. 



ASSEMBLE SOURCE PROGRAM, LISTING OUTPUT, 
LOAD AND GO OPERATIONS 



!ROV 



!PMD 



IOLOAD (MAP, PROGRAM), GO 



Source Deck 



^ 



IMACRSYM SI,LO,GO 



[JOB 



y 



In this example, the binary object program produced from 
the assembly is placed in a temporary (GO) file from which 
it is later loaded and executed. The resultant file is 
always temporary and cannot be retained from one job to 
another. The Overlay Loader loads the program root 
into the OV file for execution. A postmortem dump is 
specified. 



Compressed Deck 



-END 



Source Deck 




m 



Update 
Deck 



+ 7,9 



Source Deck 



+ 5 



Source Deck 



— | IMACRSYM SI, CI, LP, LU " 

' UOB \ 



In this example, the compressed input (deck) is received 
from the CI device, listing output is produced on the 
LO device, and listing of the update deck is also pro- 
duced on the LO device. The update deck is enclosed 
in the bracket. 
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ASSEMBLE SOURCE PROGRAM, COMPRESSED OUTPUT 
ON CARDS, LISTING OUTPUT 



Next Command 



Source Deck 



IMACRSYM SI,CO,LO 




y 



In this example, the compressed card output is procuded on 
the CO device. 

ASSEMBLE SOURCE OR COMPRESSED PROGRAM IN BATCH 
MODE, LISTING OUTPUT 



!EOD 



!EOD 



Source or Compressed Inp 



== 7v 

nput vr 



!EOD (optional) 



Source or Compressed Input 



!EOD (optional) 



Source or Compressed Input 



^a 



IMACRSYM SI (or CI),LO,BA 



UOB 



In this example, successive assemblies are performed with 
a single MACRSYM command until a double EOD is read. 
The device assignments and options on the MACRSYM com- 
mand apply to all assemblies within the batch. A program 
is considered terminated when an END Macro-Symbol di- 
rective is processed. 

When batch assemblies consist of successive updates from 
card input to compressed programs from the RAD or tape, 
the updates are terminated by a ^-END card and should not 
be separated by !EOD cards. There must be a one-to-one 
correspondence of update packets to compressed programs. 
End-of-job is signaled by end-of-file conventions applied 
to the CI device. 



ASSEMBLE SOURCE PROGRAM, BINARY OUTPUT ON 
CARDS, LISTING OUTPUT 



Next Command 



Deck 



IMACRSYM 



UOB 



f 



In this example, the SI, LO, and BO assignments are as- 
sumed by default. 

ASSEMBLE SOURCE PROGRAM, COMPRESSED OUTPUT 
ON RAD FILE, LISTING OUTPUT 



Deck 




IMACRSYM SI,LO,CO 



IASSIGN (M:CO,Dl, COMPRESS) 



U. 



:(RSIZE,30) 



^FORMAT^UFSIZE^OO), ; 



:ALLOT (FILE, DECOMPRESS),; 



IRADEDIT 



UOB 



In this example, the CO device is assigned to a RAD file 
called COMPRESS in a background data area of the RAD. 
The compressed output is written on the COMPRESS file. 

ASSEMBLE COMPRESSED DECK FROM RAD FILE, SOURCE 
UPDATES FROM CARDS, LISTING OUTPUT 



END 



Update Deck (-i-Cards and Source) 



IMACRSYM SI,Cl,LO 



IASSIGN (M:CI,D1, COMPRESS) 



UOB 



V 



In this example, the CI (compressed input) device is assigned 
to the COMPRESS file in a background area of the RAD. 
The source update deck will be read from the SI device. In 
effect, this will update the assembly given in the pre- 
vious example. 
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ASSEMBLE SOURCE PROGRAM, WRITE COMPRESSED 
OUTPUT ON 9-TRACK TAPE, LISTING OUTPUT 



ASSEMBLE COMPRESSED PROGRAM FROM 
9-TRACK TAPE, LISTING OUTPUT 



Source Deck 



1MACRSYM SI,CO, LO- 



IRE W9TA83 



! ASSIGN (M:CO,9TA83) 



UOB 



J 



!MACRSYMCI,LO 



! REW 9TA83 



1 ! ASSIGN (M:CI,9TA83)~ 



!JOB 



In this example, the COdevice is assigned to the designated 
9-track magnetic tape unit to receive the compressed output. 



In this example, the CI device is assigned to the desig- 
nated magnetic tape to read the compressed input to be 
assembled. This is the next logical job step to follow 
the previous example. 
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FORTRAN JOB EXAMPLES 

COMBINED FORTRAN COMPILATIONS, PLUS FORTRAN COMPILE AND EXECUTE 



!FIN 



!EOD 



Da fa Deck 



Z 



1 ! ROV 

| iOLOAD (MAP, ALL), Go" 



!EOD 



FORTRAN Source Deck 




IFORTRANH LP, GO 



!EOD 



£. 



£ 



7\ 



FORTRAN Source Deck 



IFORTRANH LS 



IEOD 



Z 



! FORTRAN Source Deck 




!EOD 



1. 



FORTRAN Source Deck 




IFORTRANH LO 



UOB 



f 



In fh Is example, the first two source decks are compiled with mixed (source and object language) listed output. The next 
source program (3) is compiled with a source listing (only) being output. The final source deck (4) will compile with the ob- 
ject module being output on both the BO and GO files. The Loader inputs the object module from the GO file to form the 
Root and outputs the executable program to the OV file. The program (called OV) is executed via the !ROV command. 
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COMPILE AND EXECUTE FORTRAN SOURCE PROGRAM WITH REAL-TIME LINKAGES 



IFIN 



Data Deck 




/- 



I !ROV 

|iOLOAD GO, (MAP, ALL)" 



FORTRAN Source Deck 




1FORTRANH SI,LS,BO,GO,RT 



! ASSIGN (M:BO,BP,BOFORT) 



(FORMAT,B),(RSIZE,30),(FSIZE,50) 




I 



In this example, the RAD Editor allots a file called BOFORT in binary format to the Background Programs area of the RAD. 
The specified record size is 30 words; the file size is 50 records. The 'ASSIGN command assigns the M:BO DCB (binary out- 
put) to file BOFORT. The IFORTRANH command specifies that symbolic input is to be read from the SI device, the source 
input is to be listed (under RBM, LS would be redundant if LO was specified in addition to LS), and the binary output is to 
be written out on both the BO and GO files. The relocatable binary output on the file "BOFORT" may be used as input to 
the Overlay Loader at a later date. Since the real-time option (RT) is specified, the linkage will be set up for real-time sub- 
routines. The Overlay Loader (IOLOAD) reads input from the GO file, outputs an ALL map, searches the System Library (by 
default), and writes the executable program into the OV file. The program is run via the ! ROV (Run OV) command. Note 
that a program with real-time linkages can also run in the background in nonreal-time mode. 
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COMPILE AND EXECUTE PROGRAM USING LS, BO DEFAULT OPTIONS 



£l 



!FIN 



Data Deck 




!ROV 



:ROOT (FILE,BP,BOFORT) 



IQLOAD (MAP, ALL) 



!EOD 



A 



y 



FORTRAN Source Deck 




IFORTRANH 



! ASSIGN (M:BO, BP,BOFORT) 



:(FORMAT,B),(RSIZE,30),(FSIZE,50) 



:ALLOT (FILE,BP,BOFORT); 



IRADEDIT 



!JOB 



J 



In this example, the LS (list source) and BO (binary output) are assumed by default on the FORTRANH command. The System 
Library is searched via the default option on the lOLOAD command. 
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COMPILE A FORTRAN PROGRAM AND SETUP FOR EXECUTION IN FOREGROUND AREA 



H 



I FIN 



!ROV 



:(MAP,ALL]j(FORE,4000) 



IQLOAD (GO),(TEMP / 600); 



EOD 



MMMWiMi 



FORTRAN Source Deck 



IFORTRANH LS, GO 



! PAUSE KEY-IN FGC 



IATTEND 



!JOB 12345,D,F 




In this example, the IATTEND command will inhibit the Monitor ABORT routine so that corrective action can be taken at the 
console in case of error. The FORE option on the lOLOAD command gives the FWA of the program in the Foreground area of 
memory. 
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OVERLAY LOADER EXAMPLES 

BATCH, USING GO LINKS 



A 



!ROV 



!PMD 



SOLOAD (GO, LINKS), MAP 



J 



FORTRAN Source Deck 
J IFORTRANH SI f GO r LO,LS 




FORTRAN Source Deck 




1FORTRANH SI,GO,LO,LS 



FORTRAN Source Deck 



1FORTRANH SI,GO,LO,LS 



A 




!JOB 



!ROV 



!PMD 



!VFC, (RECL, 133) 



! ASSIGN (F:2,LPA02),BCD; 



IOLOAD GO,(UDCB,1),MAP 



FORTRAN Source Deck 




1FORTRANH SI,GO,LO,LS 



!JOB 



y 



In this example, the GO file is rewound by the initial UOBcommand for the first FORTRAN compilation. The Overlay Loader 
loads from the GO file to form a root and outputs on the OV file for execution. A SHORT map will be output. A postmortem 
dump is requested if the background aborts. The next ! JOB command rewinds the GO file and three FORTRAN jobs are com- 
piled, with the binary object modules output on GO to form ROM1 ,ROM2,ROM3. The Overlay Loader loads the first ROM 
for the root, the second ROM for segment 1, and the third ROM for segment 2. Note that :SEG cards are not required. The 
programs are executed from the OV file. A SHORT map is output. A postmortem dump is specified in case an abort occurs. 
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Overlay Loader Examples 



SEGMENTED BACKGROUND JOB 




:(DEVICE,CRA03,EOD) 
-|:SEG (LINK, 1, ONTO, 0)7 



:ROOT 



1CALCLOAD) 



lOLOAD (MAP,ALL),{FILE,BP,; 



J 




Source Deck 
|!FORTRANH SI,GQ,LQ,"lT 



! ATTEND 



IJOB 



/ 



In this example, the JOB card rewinds the GO file, the FORTRAN source deck is compiled, and the binary object module 
is output on GO. The Macro-Symbol compressed source deck is updated and the binary object module is output to file CALC2 
in the D5 area (previously allocated by the RAD Editor). The ROMs designated on the :ROOT and :SEG commands are loaded, 
and the loaded program is output to CALCLOAD in the BP area. The :ROOT command causes the ROM created by FORTRANH 
to be loaded from the GO file and creates the Root. The ROMs following the first :SEG command are loaded until IEOD is 
encountered and segment 1 is then created. The next :SEG command loads the ROM assembled by Macro-Symbol on the 
CALC2 file in the D5 area and creates segment 2. The last :SEG command loads one ROM from the CALC3 file in the D5 area 
(ROM previously created by an assembly or compilation). The ! RUN command executes the loaded segmented program. 
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FOREGROUND JOB EXAMPLES 

LOAD AND EXECUTE FOREGROUND PROGRAM 



!FIN 



4 



!RUN FP.FINT 



TX 



Binary Object Deck 



:ROOT(ENTRY,INIT),(DEVICE,CRA03) 



:(FILE,FP,FINT),(MAP,PROGRAM) 



lOLOAD FORE, (TASKS,]); 



m 



y 



:ALLOT (FILE,FP,FINT),(FSIZE,25) 



IRADEDIT 



1MESSAGE LOADING FG TEST JOB 



IATTEND 



! PAUSE KEY-IN FSC 



[JOB 



In this example, the RAD Editor allots a file, (FINT) in the Foreground Programs (FP) area of the RAD. The Overlay Loader loads 
the binary object deck in the file FINT in core image format. The ! RUN control command causes execution of the foreground 
program. A PROGRAM map is specified. 
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LOAD AND EXECUTE SEGMENTED FOREGROUND PROGRAM 



M 



!FIN 



!RUN FP,FSEG 



Binary Object Deck 




:(EXLOC,7C00),(DEV,CRA03) 



:SEG (LINK 2,ONTO,0); 



Binary Object Deck 
| :(EXLOC,7A00),(DEV,CRA03) 



^ 



:SEG (LINK 1,ONTO,0); 



Binary Object Deck 




:(DEV,CRA03) 



•.ROOT (ENTRY,OVFOR); 



:(FILE,FP,FSEG),(MAP,ALL) 



IOLOAD (FORE),(TASKS,l); 



| :ALLOT (FILE,FP,FSEG) f (FSIZE,25) 



1RADEDIT 



IMESSAGE LOADING FG TEST JOB 



[ATTEND 



! PAUSE KEY-IN SFC 



!JOB 



In this example, the RAD Editor allots space for a file called FSEG in the Foreground Programs (FP) area of the RAD. The 
Overlay Loader loads a root and two segments into FSEG in core image format. The overlaid program is executed via the 
! RUN control command. An ALL map is requested. 
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9. SYSTEM GENERATION 



System Generation provides the means of forming a Monitor 
system adapted to the specific requirements of the user's 
installation. This is done by processing a set of installa- 
tion control commands. The entire System Generation 
comprises two processes: SYSGEN and SYSLOAD. Dur- 
ing the SYSGEN phase, only the specific installation 
parameters are input, not the processors. This permits 
the later replacement of modules on the HAD without 
going through an actual SYSGEN, provided that the re- 
placements do not exceed their SYSGEN defined area. 
The only output from SYSGEN is an optional rebootable 
version of SYSLOAD (System Load). 



SYSLOAD phase performs the loading of the entire RAD. 
That is, it loads the Monitor, the RBM Overlays, the Job 
Control Processor, any Optional Routines, the System Pro- 
cessors, User Processors, and other installation specific 
programs. 



To eliminate the necessity for a complete reload, a new 
Monitor can be written without disturbing the remainder of 
the RAD. 



the RAD areas. The RAD area portion of the map will con- 
tain the following information: 

MAP Heading Meaning 



AREA 



DISC 



FWA 



LWA 



NSPT 



NWPS 



The two-character name of the RAD 
area (i.e., SP, BP, FP, D3, etc.). 

The device number of the RAD on 
which the area is located (i.e., ADO). 

First word address of the area in the 
format xxx/yy, where xxx = track 
number in decimal, yy = sector num- 
ber in decimal. 

Last word address of the area (same 
format as for FWA). 

Number of sectors per track, in dec- 
imal, for the RAD on which the area 
is located. 

Number of words per sector, In dec- 
imal, for the RAD on which the area 
is located. 



SYSGEN 



OVERVIEW 

SYSGEN and SYSLOAD are assembled as one absolute mod- 
ule and then loaded by a stand alone loader. After the 
SYSGEN/SYSLOAD object module has been loaded, con- 
trol is transferred to SYSGEN. SYSGEN inputs the installa- 
tion specific parameters and sets up, in low core, all RBM 
tables and flags that are dependent upon these parameters. 
SYSGEN also builds a Symbol table containing the EBCDIC 
names of all RBM fables and the address where each table 
is loaded in memory. During the loading of RBM, this Sym- 
bol table will be used by SYSLOAD to satisfy any Monitor 
references (REFs) to these tables. 



After SYSGEN has input its final control command, it will 
optionally output a rebootable binary deck in core image 
format containing the RBM fables, the RBM flags, and 
SYSLOAD. This rebootable deck can later be used to load 
a new version of the Monitor without going through a 
SYSGEN. 



Upon request, SYSGEN will also output a map showing the 
core allocation (estimated background first word address, 
foreground first word address, etc.), the aforementioned 
Symbol table definitions and values, and the allocation of 



V/P Write protection code for the area. 

The codes are 

N No one can write in the area (un- 
less an ' SY 1 key-in is in effect). 

B Only background can write in 
the area. 

F Only foreground can write in 
the area. 

M Only the Monitor can write in 
the area. 

X Only IOEX can write in the 
area. 

A sample map output bySYSGEN is illustrated in Figure 17. 

Control is transferred to SYSLOAD following the comple- 
tion of either the SYSGEN operation or loading of the re- 
bootable SYSLOAD deck. 



CORE ALLOCATION 



CORE LAYOUT AFTER SYSGEN 

After SYSGEN has executed and before control is trans- 
ferred to SYSLOAD, core memory has the layout dis- 
played below. 
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JM8NIT&R 
IRESERVE 
IDEVICE T 
IDEVICE 
IDEVieE 

idevice 
:device 
:device 

I (BP*50) 
: (D3j5* 
: (09*5* 
IDEVICE 9 
IDEVICE 

idevice 
idevice 

ISTDLB 



1 (B9*CP 
: (SI.CRA 
: (F5/0) 

IALL88T ( 

ictint (C 

IINTL3 (I 
I (C3i5A) 
JSYSL8AD 



<C8RE*32)*ALLSIM* (ACCNT«F8) 

(RSDF,4)j CFFP88L*2)*(FRGD/5)j ( FR AD* 5 ) * (BRAD/ 5 ) j ( F T9Q,4 ) * (FmBBX, 100 ) 

YA01 

RA03 

PA04 

PA02 

TAEO 

DCCF0*S)j(ENITRaCKj511)»(MSPT«12># (NWPS,256)> ( SP, 80 ) » ( FP,50i J 

*(D1j30jB)i (D2,30,F)J 

F)j <D4*5jB), (D5*5,B)#(D6>5,B>/ <D7,5jF) , (08/ 5* B ) ; 

F)j (DA#5/B)j (DB/5,F)/(DC/5/B)* (0D>5/F),(DF,1,3)/ (XA,10n> 

TA80 

TA81 

TA82 

TAg3 

»CRA03)»(eCf TYA01)*(L9»LPA02)» ( LLi LB )/ (08/ L8 ) I 

A04)/ <SI#CRA03)* (Se,9TA81),(XX,0)*(YY/0>/(HT/OW 

03>*(BI,SI)i (F1/9TA81)/ (F2/L8)/ (F3/9TA83)/ (F4/7TAFOJ 

i (F6/9TA82)/ (C8/88)/ (CI/SI) 

G8j8)*(9VM5) 

T,65)/<HI/65) 

1j60)> (12*61 >i < 13/62)* (14/63) i (I5i64)i 

*<FC»63>/(FX/64>* ( IX/62) 

t IN,CRA03)/ALL, <V,Q02>, (MAP/LPA02) 



BCKG, 
FQDt 
FMB8X 
**«* pg 
MASTD 

0CT5 
DCT10 
0CT15 

CIT1 

ieo3 

1938 

18013 

RFT4 

RFT9 

RFT14 

FP2 

9PLBS2 

8VLBA02 



FWA«01E00 
FWA-07800 
FWA-07D99 
H TABLE ALL9CATI 



■ 0066 

■ 009F 

• OOBF 
■00F1 

■024E 

• 0258 

■ 0266 

■ 027C 
■02C6 
«02EE 
■0316 

• 0342 

■ 035A 

• 0373 



0CT1 

DCT6 

0CT11 

0CT16 

CIT? 

I9Q4 

I9Q9 

I»314 

RFT5 

RFT10 

RFT15 

FP3 

RPL3S3 

8VL9AD3 



■ 0090 

■ 00A2 

■ooc4 

■00F2 

■0250 

■ 025A 

■ 026E 

■ 028C 
■02D0 

■ 02F3 

■ 031B 
■03*5 

■ 0360 

■ 037« 



DCT2 

0CT7 

DCT12 

0CT17 

CIT3 
1935 

I8Q10 
RFT1 
RFT6 

RFT11 

RFT16 

FP4 

INJTLB1 

WL&CK 



■0096 
■00A5 
■OOCE 
■0108 

■0252 
*025C 
■0272 
■028C 
■02QA 

■ 0?FD 
■0320 

■ 0347 

■ 0366 
■037D 



**#• RBM PR8GRAM ALL9CATI8N 
FPS1M.06AE DECSIMa08F6 
RBM.0B34 RBKEND»1C1P 



DCT3 

DCT8 

DCT13 

DCT18 

1931 

1936 

1*011 

RFT2 

RFT7 

RFT12 

RrT17 

FP5 

INTL82 

9LAYFWA 



■ 0C<59 

■ OOAA 

■ OCDft 

■ OiOE 

• 0254 
»0?5n 

■ 0274 

• 02B2 

• 02F4 

■ 0307 

■ 0324 

• 034D 

■ 036B 

■ 03«E 



nrT4 
nrT9 

OrTl4 

dcti9 

Tftt? 

r*Q7 

T9Q12 

RPT3 

RFT8 

RFT13 

FP1 

8Pi «Sl 

8VI_<UD1 



■ 009C 

■ O0B4 

■ OOEE 

■ 0111 

■ 0256 

■ 0265 

■ C275 
-023C 

■ 02E9 

■ 0311 

■ 0336 

■ 034F 

■ 0370 



♦ ■»*» 



8YTSIM.QS72 



CvSI*«0cm 



DFI TA.0000 



• •«« (?A0 


ALLOCATION 


»••* 








AREA 


DISC 


FlNA 




LWA 


NSPT 


NWPS 


WP 


SP 


CFO 


0/ 


1 


79/11 


12 


256 


N 


FP 


CFO 


80/ 





129/11 


12 


256 


N 


BP 


CFO 


130/ 





179/11 


12 


256 


N 


8T 


CFO 


403/ 


6 


511/11 


12 


256 


B 


XA 


CFO 


296/ 





395/11 


12 


256 


X 


CK 


CFO 


396/ 





403/ 5 


12 


256 


y- 


Dl 


CFO 


180/ 





209/11 


12 


256 


e 


D2 


CFO 


210/ 





239/11 


12 


256 


F 


D3 


CFO 


240/ 





244/11 


12 


256 


F 


D* 


CFO 


245/ 





249/11 


12 


256 


B 


D5 


CFO 


250/ 





254/11 


12 


256 


B 


D6 


CFO 


255/ 





259/11 


12 


256 


B 


D7 


CFO 


260/ 





264/11 


12 


256 


F 


D8 


CFO 


265/ 





269/11 


12 


256 


B 


D9 


CFO 


270/ 





274/U 


12 


256 


F 


DA 


CFO 


275/ 





279/11 


12 


256 


B 


DB 


CFO 


280/ 





284/11 


12 


256 


F 


DC 


CFO 


285/ 





289/11 


12 


256 


B 


DD 


CFO 


290/ 





294/1 1 


12 


256 


F 


DF 


CFO 


295/ 





295/11 


12 


256 


B 


»»*# FNJO 


MAP »»■»» 













Figure 17. SYSGEN Map Example 
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Interrupts, traps, etc. 
RBM Control Task int. loc. 



Unused interrupt locations used 
for monitor tables 



System flags and pointers 



RBM tables (DCT, IOQ, RFT, etc. 



RBM overlay area 



SYSGEN 



SYSLOAD 



Symbol table 



320 
350 
700- 

1200 

10K 
12K x 



Output in 
' Rebootable 
Deck 



15K 



16K 



Output in 
► Rebootable 
Deck 



RBM STRUCTURE 

The RBM system is assembled in several different modules, 
the largest of which consists of the following nonoptional 
resident routines: 

1. I/O Interrupt Task. 

2. Control Panel Task. 

3. Tasks to process the various traps. 

4. The following Monitor functions: Foreground Exit, 
I/O Package, Interrupt Control, Segment Loader, 
I/O Handlers, IOEXand foreground service routines. 

The other RBM parts consist of the optional resident rou- 
tines, RBM Overlays, and the Job Control Processor (JCP). 
All RBM parts will be assembled as relocatable object mod- 
ules and loaded by SYSLOAD. 

The optional resident routines are the floating-point simu- 
lation routines and decimal simulation routines; they are 
input during SYSLOAD as required. 

The RBM Overlays consist of the subtasks of the RBM Con- 
trol Task, which include: 

Key-in Processor 

Background Abort/Exit Routine 

Postmortem Dump 

Foreground Root Loader 

Background Root Loader 

Checkpoint/Restart 



CORE MEMORY LAYOUT AFTER SYSGEN AND SYSLOAD 

After SYSGEN and SYSLOAD have executed, core memory 
would have the following typical layout: 



Write 
Lock < 
11 



Write 

Lock 

01 



Write 

Lock ' 
10 



Interrupts, traps, etc. 





RBM Control Task int. loc. 




Unused interrupt locations used for 
Monitor tables 


320 


System flags and pointers 


RBM tables 




RBM overlay area 




Optional resident routines 


6K 


Nonoptional resident routines 


Monitor expansion and patch area 




Background and RBM Job 
Control Processor area 


page 
boun< 

. 1 


Foreground area 




Foreground mailboxes 




Foreground blocking buffer pool 


16K 



Note that during SYSGEN, the user inputs the number of 
pages to be reserved for the foreground area. After 
SYSLOAD has loaded all resident routines and allocated 
the appropriate space for the Monitor patch area, the start- 
ing address of background will be fixed at the start of the 
next page. The starting address of background can not be 
precisely determined until all resident routines are loaded 
by SYSLOAD. For this reason, the background first word 
address output on the map by SYSGEN is necessarily an 
estimated address, and would be changed by SYSLOAD if 
the SYSGEN estimate was incorrect. The background will 
extend up to the start of the foreground area. 



RAD ALLOCATION 

RAD AREAS 

During SYSGEN, the total user RAD space can be divided 
into a maximum of 21 areas, the size of which can not be 
changed except by a new SYSGEN. A subdivision of an 
area is a file, and each area can consist of several files. 
Files are defined through the RAD Editor after SYSGEN, 
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and can be created or deleted at any time without going 
through a SYSGEN process. In the order of their normal 
RAD allocation, the RAD areas are as follows: 



Table 17. RAD Area Default Sizes 



Name Code Write Protect Code 



SP 


N 


FP 


N 


BP 


N 


Dl through DF 


For B 


XA 


X 


CK 


M 


BT 


B 



AREA NAME 

System Programs 

Foreground Programs 

Background Programs 

Foreground and 
Background Data 

IOEX Access 

Checkpoint 

Background Temp 



If the RAD areas are allocated in the order given above, 
the user can easily protect all the programs on the RAD 
through the hardware write protect switches. 

The user can specify a given area to physically reside on 
any RAD in the system if the system contains more than one 
RAD; however, each area must be wholly contained on one 
RAD. The user must also specify a RAD to be the System 
RAD that will contain the SP area and receive the RBM 
Bootstrap. The user inputs the number of words per sector 
and number of sectors per track for each RAD in the system 
and SYSGEN stores this information in the Master Directory. 

The System Programs area of the RAD contains the Monitor, 
service processors (Overlay Loader, RAD Editor), system pro- 
cessors (Macro- Symbol, FORTRAN IV-H, etc.), and the 
System Library. 

The Foreground Programs area of the RAD should contain 
the user's foreground programs, the Public Library, and the 
User Library, if they exist. 

The Background Program area should contain any back- 
ground programs of the user. 

The IOEX Access area can be written only by IOEX and 
should normally be the only area of the RAD that IOEX 
is allowed to access. 



The Foreground and Background Data areas can be used to 
store the appropriate type of user data. Up to fifteen 
Data areas (Dl-DF) are allowed, to accommodate a user 
with multiple RADs. 

The Checkpoint area is used to save the contents of back- 
ground core memory during a checkpoint. The Background 
Temp area can be allocated to a maximum of nine scratch 
files (X1-X9) plus the GO and OV files. 

If a user does not choose to specify the sizes for the 
different RAD areas, the default sizes given in Table 17 
will be assumed, and the total area will be allocated 
to the System RAD. 



Area 


Default Size 


Comments 


System 


60 tracks 


Large enough to con- 


Programs 




tain all system pro- 
cessors, one per file, 
in core image format; 
the system library in 
relocatable binary for- 
mat; and the Monitor 
in core image format. 


Foreground 





User is required to 


Programs 




specify number of 
tracks for all areas 
not used by system 
programs. 


Background 







Programs 






Foreground/ 







Background 






Data 






IOEX Access 







Checkpoint 


n sectors 


Where n = the initial 
size of background in 
sectors. 


Background 


m sectors 


Where m = remainder 


Temp 




of RAD. RAD size is 
determined from the 
EN TRACK parameter 
on the :DEVICE 
command. 



The areas will be physically located on the RAD in the same 
order as they were input during SYSGEN. The System Pro- 
grams area will be the first area on the System RAD unless 
the user inputs the SP area in a different order. In both the 
initial and succeeding SYSGENs, all RAD areas required 
by the user must be input, except those areas that SYSGEN 
automatically allocates by default. In succeeding SYSGENs, 
the user must input all areas in the same order and with the 
same size as the initial SYSGEN to prevent destruction of 
any RAD areas. 

Beginning at the starting track address input on the rDEVICE 
command, SYSGEN will allocate the number of tracks for 
each area without leaving empty spaces between areas. A 
bad track on a user's RAD can be skipped via an input to 
the RAD Editor at the time the user's files are defined. The 
first area allocated on the System RAD will include the RAD 
Bootstrap among its allocated space, and therefore, the 
actual space allocated for the area will be one sector less 
than the number of tracks input. This technique forces each 
area to start on a track boundary to make the hardware 
Write Protect switches easier to use. 

BACKGROUND TEMP AREA 

The scratch files (XI through X9) of the Background Temp 
area of the RAD will be automatically al located and defined 
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by the Job Control Processor prior to execution of a back- 
ground program, unless the user wishes to override these 
defaults via an JALLOBT control command. During SYSGEN, 
the user will not specify any standard sizes for the scratch 
files, X1-X9. The X1-X9 files are normally destroyed and 



subsequently reallocated before execution of each 
ground y ri r rrm in a job jMe l n. o. i '" f * ° 

The GO and OV files are also in the BT area of the RAD. 
These files are more permanent than the X1-X9 files and 
are maintained throughout an entire job. The user has the 
option to override the default permanent size of GO and 
OV at SYSGEN via the :ALLOBT command. GO and OV 
have both a permanent size, determined at SYSGEN, and 
a temporary size, which can be input through the back- 
ground job stack via an :ALLOBT control command. 

An example of allocation for a System RAD is given in 
I Figure 18. 






RAD Bootstrap 


SP Area 


FP Area 


BP Area 


Dl Area 


D2 Area 


XA Area 


CK Area 


BT Area 



/ One \ 
\ sector/ 



60 tracks 

(default 

size) 



Size must be 
> specified by user or 
area not allocated 



Size of background 
(default size) 
Remainder of RAD 
(default size) 



Figure 18. RAD Allocation Example 



Table 18 gives the default sizes and types for GO, OV, and I 
X1-X9, and the order in which the files are allocated. Note 
that X1-X9 are at the front of the BT area, and GO and OV 
are at the opposite end. 



^ ro, TABLES ALLOCATED AND SET BY SYSGEN 

DEVICE CONTROL TABLE (DCT) 

The DCT table is allocated by SYSGEN and several of the 
entries in the table are set by SYSGEN (i.e., device type, 
device number, dedicated to foreground bit, etc.). The 
DCT contains one entry for each device input by the user 
on the rDEVICE command, and the order of the entries is 
the same as the order of the rDEVICE commands. Note that 
there will be only one entry in the DCT for each RAD. 

RAD FILE TABLE (RFT) 

The RAD file table is allocated by SYSGEN from the FRAD 
and BRAD entries on the ;RESERVE command, and should 
contain sufficient entries to reflect the maximum number of 
open RAD files that can exist simultaneously. The user will 
input the number of RFT entries to be reserved for foreground 
programs and the number to be reserved for background pro- 
grams. The background is not allowed to use more than the 
number of RFT entries allocated for the background. How- 
ever, the foreground can use all RFT entries if they are 
needed. The rationale for having foreground/background 
RAD files as opposed to a single pool of files is that a back- 
ground program could erroneously use all the file entries, 
thus preventing the operation of a foreground program. 

MASTER DIRECTORY 

The Master Directory is entirely set up by SYSGEN in the 
resident Monitor portion of memory and contains the fol- 
lowing information about each area on the RAD: the sec- 
tor address of each area, the RAD to which the area is 
assigned, the sector size and number of sectors per track; 



Table 18. GO, OV, X1-X9 Default Sizes 



File Name 


File Type 


Default Size 


Comments 


XI " 

X2 

X3 

X4 

X5 

X6 

X7 

X8 

X9 J 


► 


Unblocked 


Determined by Job 
Control Processor at 
execution time. 


File type and record sizes can be changed through 
a Device Mode function call or through an ! ALLOBT 
command. 


OV 


Unblocked 


8 tracks 


Default output for Overlay Loader. Used mainly 
to test a program that has no permanent file defined, 
or to test a new version of a program without de- 
stroying the current version. 


GO 


Blocked (120 bytes/ 
logical record) 


8 tracks 


Used by FORTRAN and Symbol for "assemble and 
go" type operations. 
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a bit that states if an area has been allocated; and the 
write protection code for the area. 

RBM OVLOAD TABLE 

The RBM OVLOAD table is entirely set up by SYSLOADand 
contains the information the Monitor needs to load a Moni- 
tor overlay. This information consists of an overlay identi- 
fier, the relative RAD address of the overlay, and the num- 
ber of bytes in the overlay. 

I/O QUEUE TABLE (IOQ) 

The IOQ table is allocated by SYSGEN from the FIOQand 
BIOQ entries on the :RE5ERVE command. The user inputs 
the maximum number of I/O operations that can be queued 
at one time for the foreground and background. The restric- 
tions on the use of the foreground IOQ table are the same 
as for the RAD File Table. 

FOREGROUND PROGRAM TABLE (FGT) 

The Foreground Program table contains an active entry for 
each foreground program loaded into memory. Requests to 
load a foreground program can be made from either another 
foreground program or by the operator. Space for this table 
is allocated by SYSGEN from the FRGD entry on the 
:RESERVE command. 



INTERRUPT LABEL TABLE (INTLB) 

The INTLB table is set up by SYSGEN from information con- 
tained on the :INTLB command. The table contains the 
name of each interrupt and the location to which the inter- 
rupt is assigned. 



INPUT PARAMETERS 

After the absolute object module of SYSGEN and SYSLOAD 
has been loaded by a stand-alone loader, control is trans- 
ferred to SYSGEN. SYSGEN types the following messages 
on the typewriter (note that the typewriter must be assigned 
to IOP zero, device 01; that is, TYAOI): 



RBM SYSGEN 

IN, OUT DEVICES? 



The user will input the following control command in re- 
sponse to the query. All SYSGEN commands must begin 
with a colon in column one. 

/: SYSGEN (IN,yyndd) [ (OUT,yyndd[,LP] )] 



OPERATIONAL LABEL TABLE (OPLBS) 

The OPLBS table is built by SYSGEN from the information 
input on the :STDLB command. The table has a minimumof 
eleven entries that contain the standard Monitor operational 
labels. Since operational labels are referenced via an in- 
dex value in the DCB, each of the eleven standard oper- 
ational labels have a fixed index value. If the user adds 
his own operational labels to the table, the user oper- 
ational labels are assigned an index value, starting with 
13, in the order in which they are input on the :STDLB 
command. The standard operational labels are 



IN 



specifies the device in the format yyndd from 
which the remainder of the SYSGEN control com- 
mands will be input. 

yy is a device type code and must be either 

CR, TY, or PR (see below for a description of 
the codes). 

n is the IOP; legal values are A-H correspond- 

ing to IOP's 0-7. 



dd 



is the hardware device number of the devi 



ce. 



Op Label 


Index Value 




C 


1 ^ 






OC 


2 






LO 


3 






LL 


4 






DO 


5 






CO 


6 


► 


Standard operational 


BO 


7 




labels 


CI 


8 






SI 


9 






BI 


10 






SO 


11 






PL 


12 „ 






XX 


13 ' 




User-defined operationa 


yy 


14 


> 


labels; (index value de- 
pendent upon order on 
:STDLB command) 



OUT specifies an optional output device on which 

the input commands are to be logged or the map, 
if requested, is to be output. The device type code 
must be either the TY or LP. 

The optional LP field specifies the lower perfor- 
mance line printer (225 lines per minute) as op- 
posed to the 1000 line-per-minute printer. 

Following input of the :SYSGEN command, the SYSGEN 
control commands are input through the specified device. 



The stand-alone loader types out the query "INPUT DEVICE". 
The operator should respond by typing in the device from 
which the absolute object module of SYSGEN and SYSLOAD 
is to be loaded. Examples of a possible response are: 
CRA03, 9TA80, PRA05. 
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The following device types are standard under RBM, and 
should be input in the yy portion of a yyndd parameter in 
all SYSGEN control commands. 



Device Type Code 



Device 



TY 


Typewriter 


LP f 


Line printer 


CR 


Card reader 


CP* 


Card punch 


9T 


9-track magnetic tape 


7T 


7-track magnetic tape 


PP 


Paper tape punch 


PR 


Paper tape reader 


DC 


RAD or other disc 


PL 


Plotter 


NO 


Not a standard device 



A special purpose device 
for use with IOEX. 

SYSGEN CONTROL COMMANDS 

The SYSGEN control commands are given below. The 
:MONITOR and :RESERVE commands (in that order) must 
be input prior to the :DEVICE command. A :DEVICE com- 
mand must precede a :STDLB command that references that 
device. 

MONITOR The :MONITOR command specifies Monitor 

and CPU options. The :MONITOR command must precede 
the : RE SERVE command and must precede the :DEVICE com- 
mand for the System RAD. 

The command has the form 



r. 



:MONITOR (option) [, (option) . . . , (option)] 



where the options are 

CORE, size specifies the memory size, in decimal 

units of K (where IK = 1024 words), of the target 
computer (computer for which the SYSGEN is 
being run). Thedefault value forCORE is 16K words. 

FPSIM specifies that the floating-point simulation 

package is to be loaded by SYSLOAD. If this 
parameter is absent, either the floating-point 
hardware exists or floating-point is not needed 
for the target computer. 



If the optional LP (lower performance) parameter is in- 
put with a CP or LP device type, the device is the 255- 
line-per-minute printer in the LP case, or the 100-card- 
per-minute punch in the CP case (i.e., LPA02, LP or 
CPA04, LP). 



DECSIM specifies that the decimal instruction simu- 

lation package is to be loaded by SYSLOAD. The 
absence of this parameter indicates that either the 
decimal instruction hardware exists or the decimal 
package is not needed for the target computer. 

BYTSIM specifies the byte string instruction simula- 
tion package is to be loaded by SYSLOAD. 

CVSIM specifies the convert instruction simulation 

package is to be loaded by SYSLOAD. 

ALLSIM specifies that all software instruction simu- 
lation packages are to be loaded by SYSLOAD. 



-If.} 



ACCNT, \ "„} specifies that the Monitor is to per- 
form job accounting. B or FB specifies the type 
of accounting. B indicates background accounting 
only, with all foreground time included in the back- 
ground job time. FB indicates foreground/background 
accounting, with the foreground time kept separate 
from the background time. If the FB type is chosen, 
the foreground interrupt response time could be in- 
creased by a maximum of 5 microseconds. Absence 
of the ACCNT parameter indicates that no job ac- 
counting is to be kept. 

LPP,value is number of lines per printer page. The 

default is 37. This value is used by processors that 
perform their own vertical format control of the 
printer. 

:RESERVE The :RESERVE command allocates areas of core 

and the various variable length Monitor tables. The:RESERVE 
command must precede the :DEVICE command for the System 
RAD. 

The :RE SERVE command has the form 

:RESERVE (option) [, (opt ion) . . . , (option)] 



where the options are 

RSDF,value specifies the decimal number of pages 

to be reserved for foreground programs. The value 
specified includes the foreground mailbox (FMBOX) 
and foreground blocking buffer (FFPOOL) areas, 
if any. This space is available for all foreground 
programs on a first-come, first-served basis. A 
program is given its predetermined core space (de- 
termined when it is loaded on the RAD by the 
Overlay Loader) when loaded for execution. No 
other program can use this space until the program 
is unloaded. The Public Library will also exist 
in this foreground space. The default value is 
zero. 

MPATCH,size specifies the decimal number of 

word locations to be reserved for modifications 
and expansion of the Monitor. The default 
size is zero. 
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FFPOOL, value specifies the decimal number of 

256^word blocking buffers to be allocated for all 
foreground programs. AThe default value is zero. 

FRGD, value specifies the maximum number of fore- 

ground programs that can reside in core memory at 
any one time. This parameter will be used to allo- 
cate space for the foreground program table that is 
used to manage the foreground core area. The de- 
fault size is zero. Maximum allowable value is 225. 

FRAD, value specifies the number of entries to re- 

serve in the RAD File Table for foreground RAD 
files. This number should reflect the maximum 
number of foreground RAD files that could be open 
simultaneously. Note that the background RAD 
pool is also available to the foreground. The de- 
fault value is zero. 

BRAD,value specifies the number of entries to re- 

serve in the RAD File Table for background RAD 
files. This number should reflect the maximum 
number of background RAD files that can be opened 
simultaneously. The default value is 5, which will 
be sufficient to accommodate the System Processors. 
The value indicated should not include the files 
on the BT area of the RAD. 

FIOQ, value specifies the maximum number of 

foreground I/O operations that can be queued at 
any one time. This parameter determines the space 
allocated for foreground entries in the I/O queue 
table. Note that the background queue table is 
also available to the foreground. The default 
value is zero. 

BIOQ, value specifies the maximum number of back- 

ground I/O operations that can be queued at any 
one time. This parameter determines the space 
allocated for background entries in the I/O queue 
table. The default value allows three entries to 
be placed in the queue table. 

Note that the sum of FIOG and BIOQ must be 
less than 256, or an error indication will be 
given. 

FMBOX,size specifies the decimal number of 

word locations to reserve at the end of the 
foreground core space for foreground mailboxes. 
The default value is zero. 

BT, value specifies the maximum number of Back- 

ground Temp files (XI -X9) that will ever be used. 
The default value is 6, that is, files XI, X2, 
X3, X4, X5, X6. Six files are sufficient for the 
System Processors. The files defined are Xl-Xn, 
where n is the input value. The 'n' must be 
less than 10. 

:DEVICE The :DEVICE command introduces peripheral 

units into the system. One -.DEVICE command is required 
for each peripheral unit to be used. The order of the 
:DEVICE commands determines the Device Control Table 
index value that the device will receive (the index value 
can be used in theDCB). If an error is made in any field 
of the command, the entire command must be input again. 



The :DEVICE command has the form 

:DEVICE (yyndd [, LP] [,S])[, (option)] [, (option)]. . . 



yyndd specifies the device name (see the :SYSGEN 

command for a description of yyndd). If yy = NO 
(for an IO EX device) the device will automatically 
be dedicated to IOEX. 

LP specifies that the device is the lower perfor- 

mance type; e.g., LP would be used to differen- 
tiate the lower performance card punch (100 cards 
per minute) from the unbuffered card punch, or the 
lower performance printer from the high speed 
printer. If LP is absent, the higher performance 
device is assumed. 

S specifies (for a RADdevice only) this RAD as the 

System RAD; the System RAD receives the Boot- 
strap, the SP area, and any default al locations. 

The device name must be the first field input after the 
:DEVICE. 

The options are 

DEDICATE, value specifies that the device is to be 

dedicated to the foreground if value is "F"; it can 
be used by IOEX only if value is "X". If this op- 
tion is omitted, the device is undedicated unless 
the device is NO. In this case, the device is 
dedicated to IOEX. 

Note: The remaining options are only applicable for a 
RAD device. 

STTRACK, value specifies the starting track (decimal 
track number) on the RAD that is to be used by the sys- 
tem. If the option is omitted, track zero will be the 
starting track. Tracks are numbered starting with zero. 
STTRACK must be input before ENTRACK and must 
be equal to or less than ENTRACK. 

ENTRACK, value specifies the end track (in deci- 

mal) on the RAD to be used by the system. If this 
option is omitted, a value of 51 1 will be assumed. 
Note that tracks are numbered 0-n, where n<512. 
For a Model 7212 RAD, ENTRACK should be <64. 

NSPT, value specifies the decimal number of sectors 
per track. The default value is 16. For a Model 
7212 RAD, NSPT = 82, and for a Model 7232 RAD, 
NSPT= 12. 

NWPS, value specifies the decimal number of words 

per sector. The default value is 90. 

area, value specifies the decimal number of tracks 

to be allocated to the designated area (SP, FP, BP, 
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Dn, Q^XA, or BT). The various forms in which 
this option can be written are 



$P, value*' XA, value 

FP, value BT, value 

BP, value Dn, value j 
CK, value 



here 1 < n < F 



If the remainder of the RAD is to be allocated to 
an area, "ALL" can be input instead of the number 
of tracks. Any area not input on a :DEVICE con- 
trol command will receive its default allocation. 
If zero is input as a value for the number of tracks 
for the CK or BT area, the area will not be allo- 
cated. Note that for the data area, Dn (1 £ n £ F), 
an F (foreground), or a B (background) must be 
specified to indicate the write protection code for 
the area. See the "RAD ALLOCATION" section 
in this chapter. 



Examples: 



/: DEVICE CRA03 



Higher performance card reader, device number 3, on IOP 
number 0, undedicated. 

/^DEVICE (LPA02, LP), (DEDICATE^) 



Lower performance line printer, device number 2, on IOP 
number 0, dedicated to the foreground. 

/^DEVICE (DCB90,S),(ENT,127),(FP,15),(D1,10,F),(D2,10,B) 



7202 RAD, device number 90, on IOP number 1, to be used 
as the System RAD starting on sector zero, with default 
sizes for the SP, CK, and BT areas, and the input sizes for 
the FP, Dl, and D2 areas. (The BT area would receive the 
remainder of the RAD.) 



:DEVICE (DCB91),(DED,X),(STTRACK,256),(NSPT,12), 



J 



(NWPS,256),(XA,ALL) 



7232 RAD, device number 91, on IOP number 1, to be used 
only by IOEX starting on track 256 and ending on track 511. 
These tracks are allocated to the XA area. 



iSTDLB The :STDLB command defines all standard Moni- 

tor operational label assignments for the generated system 
and all standard user operational labels and their assign- 
ments. Note that operational labels cannot be assigned to 
RAD files during SYSGEN. The STDLB command must be 
input following the :DEVICE commands. 

The :STDLB command has the form 

y:STDLB (label, name) [, (label, name) . . .] 



where 

label specifies a standard Monitor operational label 

or a user operational label. All user operational 
labels must consist of two alphanumeric characters. 
Any standard Monitor operational labels not speci- 
fied on a :STDLB command will receive by default 
a permanent assignment of zero. The order of the 
user's labels determines a label's position in the 
operational label table, and therefore determines 
the OPLB value that might be present in a user 
DCB (see the table in the example below). No 
label will be allowed that is the same as a Back- 
ground Temp file name (GO, OV, X1-X9) or the 
same as a RAD area. 

name specifies a physical device name to which 

the operational label is permanently assigned, a 
numeric zero, or a previously assigned operational 
label. In the latter case, the operational label 
will be assigned to the same device as the label to 
which it is assigned. If "0" is specified, there is 
no permanent assignment. 

The :STDLB command example 

/"iSTDLB (C, TYA01), (OC, C), (LO, LPA02), (LL, LO), , 



n 



(BI, PRA05), (SI, PRA05), (PL, PLA06), (XX, PRA05), 



J 



(ZZ, LPA02) 



would set up the operational label table given below. 



Standard 
Monitor 
Op Labels 



The SP area must be allocated to the System RAD. If allo- 
cated elsewhere, an 'ERROR ITEMxx" alarm will be output. 





OPLB 


Permanent 


Label 


Index( 10 ) 
1 


Assignment 


C 


TYA01 


OC 


2 


TYA01 


LO 


3 


LPA02 


LL 


4 


LPA02 


DO 


5 





CO 


6 





BO 


7 





CI 


8 





SI 


9 


PRA05 


BI 


10 


PRA05 


SO 


11 





PL 


12 


PLA06 
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User Op 
Labels 



La be 



[XX 

izz 



OPLB 
Index(iQ) 

13 
14 



Permanent 
Assignment 

PRA05 
LPA02 



iCTINT The :CTINT command specifies the interrupt to 

which the RBM Control Task is to be connected, and the 
highest address used for interrupts on the system. 



lALLOBT The :ALLOBT command establishes the perma- 

nent sizes of the GO and OV files contained in the Back- 
ground Temp area of the RAD. 

The :ALLOBT command has the form 

/lALLOBT (file name, sizes) [, (file name, size)] 



The :CTINT command has the form 



:CTINT [(CT,address), (Headdress)] 



CT,address specifies the absolute hexadecimal in- 

terrupt location to which the RBM Control Task is 
to be connected. If the Control Task is to be con- 
nected to an interrupt, that interrupt must be the 
lowest priority interrupt used by the system. If "ad- 
dress" has the value zero, no interrupt is available 
for the Control Task. In this case, the user can 
run only background programs, andSYSGEN will 
allocate the Monitor tables beginning at address 
X'5E'. The default value for the Control Task In- 
terrupt is location X'61'. 

Headdress specifies the highest address in hexa- 

decimal needed for an interrupt. SYSGEN will 
assume that all memory locations greater than HI 
are unused and will attempt to allocate the Moni- 
tor tables in this area. The default value is 
X'13F'. Normally, CT and HI would have the 
same value. 



ilNTLB The :INTLB command provides the capability of 

associating a label with an interrupt location. The label 
may then be used in the different interrupt CALs on the 
Monitor. 

The :INTLB command has the form 

/:INTLB (label, loc) [, (label, loc). . . , (label, loc)] 

where 

label specifies a two-characteralphanumeric label. 

loc specifies the absolute hexadecimal interrupt 

location to be associated with the label. 

The key-in INTLB may be used to change the assignment of 
the label from one interrupt location to another. 



file name specifies the name of the file, which must 

be either GO or OV. 

size specifies the decimal number of tracks to be 

allocated for the specified file. The input size 
becomes the permanent size for the specified file 
and overrides the default sizes given in the 
"BACKGROUND TEMP AREA" subsection. The 
permanent size can be changed at execution time 
via an lALLOBT control command. 

:PUNCH The PUNCH command specifies that a reboot- 

able version of SYSLOAD is to be punched after SYSGEN 
has input the last control command. 

The PUNCH command has the form 



/:PUNCH devi 



where device specifies the device (e.g., CPA04) on which 
the rebootable copy of SYSLOAD is to be punched. 

:SI0P The :SIOP command defines the selector IOPs as 

opposed to multiplexor IOPs. This command is required in 
SYSGEN to correctly allocate the Channel Information 
Table for the Monitor. All selector IOPs at an installation 
must be input on this command. 

The :SIOP command has the form 

/:SIOP n,n, n,... 



where the n's indicate which IOPs are selector IOPs. The 
'n' parameter must be a one-letter character from A 
through H. 

:FIN The :FIN command signals the end of the control 

commands for the SYSGEN phase. Upon reading the :FIN 
command, SYSGEN will punch a rebootable version of 
SYSLOAD and output the map, if requested, and exit 
to SYSLOAD. The :FIN command should normally be 
used to terminate SYSGEN when it is not desired to 
continue with SYSLOAD (otherwise, the :SYSLD command 
should be used). 
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The :FIN command has the forn 



SYSLOAD 



/fin [map] 



MAP specifies that a MAP is to be output on the 

same device being used to log the SYSGEN con- 
trol commands. If no outputdevice was specified 
on the :SYSGEN command, the MAP is output on 
TYA01. 

iSYSLD The :SYSLD command also signals the end of the 

control commands to SYSGEN. The :SYSLD command causes 
SYSGEN to output the rebootable deck of RBM, if requested, 
and then exit to a SYSLOAD entry where no further control 
command input is required. 

The :SYSLD command has the form 

:SYSLD (IN,yyndd)[(OUT,yyndd[,LP]), {up D }'^ 
L(V,xxxx); (MAP,yyndd[,LP])] 



>/here 



IN specifies the device to be used for loading the 

Monitor, the RBM overlays, and all optional rou- 
tines. The device must be either CR, PR, 9T, or 
71. This field is not optional. See the SYSGEN 
command for the yyndd definition. 

OUT specifies the device to receive the hard copy 

of the RAD Bootstrap. If the System RAD allocation 
starts on sector zero, this field is optional; other- 
wise, an output device must be specified. The out- 
put device must be either CP, PP, 91, or 7T. The 
LP option specifies the lower performance card punch. 



jALL) 
lUPDj. 



specifies the SYSLOAD mode of operation. 
The "ALL" parameter indicates that all defined 
areas of the RAD are to be initialized to zero. 
The "UPD" parameter indicates that existing data 
on the RAD must be saved and only the new ver- 
sion of RBM should be output to the RAD. See 
"SYSLOAD", below, for a further description of 
these options. The default value for this parameter 
is "UPD". 



V specifies the version number of the system being 
loaded. Up to four alphanumeric characters can 
be input for the version. The version will be 
logged on LL at the start of each job and logged 
with each postmortem dump. 

MAP specifies that a MAP is to be output at the 

completion of SYSLOAD on the yyndd device. 
The device must be either LP or TY. 

See the SYSGEN control command for a description of 
yyndd. 



When the SYSGEN phase has been completed, or when the 
rebootable SYSLOAD deck punched by SYSGEN has been 
input, control is transferred to SYSLOAD. SYSLOAD loads 
the Monitor, the RBM Overlays and Optional Routines and 
outputs these to the RAD. It then outputs the RAD Boot- 
strap and the System Program's Directory to the RAD. When 
SYSLOAD terminates it enters an idle state. If necessary, 
the user can now load the system and user programs on the 
RAD by following the sequence outlined later in this chap- 
ter. If a :SYSLD command was not input to SYSGEN or in- 
put after rebooting the SYSLOAD deck, SYSLOAD will 
initially output the following messageson the TYA01 device: 



RBM SYSLOAD 
INPUT OPTIONS 



The options input on the TYA01 device must be made via 
the :SYSLD command. 

All writes made on the RAD during the SYSLOAD phase will 
be checked to ensure that the data was correctly recorded 
on the RAD. 

ALL OPTION 

The ALL option specifies that a complete system load is to 
occur and that all RAD areas should be initialized to zeros. 
The ALL option is necessary for the initial SYSLOAD or if 
the RAD allocation has changed so drastically that all areas 
on the RAD have moved. SYSLOAD initially zeros out all 
defined areas of the RAD. It then loads three groups of ob- 
ject modules in the following sequence: optional resident 
routines (FPSIM, DECSIM, CVSIM, BYTSIM); resident Moni- 
tor; and RBM Overlays and JCP. 

The three groups of object modules must be loaded in the 
stated order, but (for example) specific RBM Overlays need 
not be in any special order. All these routines can be input 
as one package and SYSLOAD will select and load only the 
routines that were requested during SYSGEN, making it un- 
necessary to rearrange the decks of the object modules if re- 
quirements change. 

Each object module is identified to SYSLOAD via a DEF 
item, and any object module not required is passed over. 
EODs are allowed between object modules, and the final ob- 
ject module must be followed by two EODs. If all the re- 
quired object modules are not present in a group, SYSLOAD 
outputs the following alarm on TYA01: 



MISSING ID namel, name2, 
RELOAD? 



where name n is the name of the missing routine, the name 
being indicated by the only DEF item in the object module 

If "Y" (YES) is input to the RELOAD query, SYSLOAD 
again reads the input device to load the missing routines. 
If "N" (NO) is input, SYSLOAD assumes the missing rou- 
tines are not required and continues. 



114 



SYSLOAD 



SYSLOAD writes the required overlays on the RAD as they 
are loaded and sets up the information needed to load the 
overlays in the RBM OVLOAD table. Modules that are not 
overlays will be loaded directly into core and later written 
out with resident RBM. 

When the directory is written on the RAD by SYSLOAD, the 
System Programs Directory will contain entries for two files 
named "RBM" and "RADBOOT". RADBOOT is the file that 
contains a copy of the RAD Bootstrap, which is the oniy pro- 
gram on the RAD not contained within a RAD area. There- 
fore, it cannot be accessed if a RAD dump or save is 
required, and for this reason a copy of the Bootstrap is kept 
in the SP area. 

The RBM and RADBOOT files will be the first two files in 
the SP area. The area on the RADallocated for the Monitor 
will include any patch or expansion core area the user has 
requested. If a new version of the RBM system exceeds the 
RAD space allocated to a previous version, all programs in 
the SP area must be reloaded. 

After RBM and the SP Directory are output to the RAD, 
SYSLOAD sets up the appropriate command list in the 
Bootstrap to enable the Bootstrap to easily reload RBM 
from the RAD. The Bootstrap is then written both into 
the RADBOOT file and onto the starting sector of the 
System RAD (SSTRACK option on rDEVICE command). 

If the System RAD a I location starts at other than sector zero, 
a copy of the RAD Bootstrap is punched on the device speci- 
fied by the OUT keyword on the :SYSLD command. The 
user can then boot in RBM by loading the hard copy of the 
RAD Bootstrap. This permits having more than one Monitor 
system on the user's RAD and still being able to boot in RBM 
by reading in a hard copy of the Bootstrap. 

UPDATE OPTION (UPD) 

The UPD option can be used whenever there is an existing 
version of RBM on the RAD, and the user wishes to load a 
new version of the Monitor or change some of the SYSGEN 
parameters. It is not necessary to go through a SYSGEN to 
load a new version of the Monitor. It is only necessary to 
load the rebootable SYSLOAD deck and go through a nor- 
mal SYSLOAD, specifying the "UPD" option on the :SYSLD 
command. 

To change any SYSGEN-defined parameters, it is neces- 
sary to input the complete set of SYSGEN control com- 
mands. That is, there is no attempt to merge the new ver- 
sion of the Monitor with the existing version on the RAD. 

If the user does not want to disturb any of the RAD areas, 
the RAD areas must be input with the same size and in the 
same order as the initial SYSGEN. If the size of a RAD 
area has to be changed or a new RAD area has to be added, 
all RAD areas (except CK or BT) must be reloaded from the 
first changed area to the end of the RAD. Therefore, the 
areas most subject to change in size should be allocated to 
the end of the RAD so that the minimum number of areas 
are affected by a change. An area that must be moved can 
be saved and restored intact by using the RAD Editor Save 



and Restore functions. It is normally to the user's ad- 
vantage to take the default size and allocation for the CK 
and BT areas since these are automatically allocated at the 
end of the RAD and may be changed without affecting any 
other area. 

To inform the user as to which areas on the RADhave moved, 
SYSLOAD reads in the RAD Bootstrap from the existing ver- 
sion, determines where the Monitor is located on the RAD, 
and then inputs the Master Directory from the existing ver- 
sion. If the absolute RAD first word address is changed for 
any of the SP, FP, BP, XA, or Dn areas, SYSLOAD outputs 
an appropriate alarm, requests permission to continue, and 
then zeros out the first sector in each area that has moved, 
thus effectively erasing all data in the area. The alarms 
that could be output are 

RELOAD 

SP AREA 

FP AREA 

BP AREA 

Dn AREA (where l<n<F) 

XA AREA 

CONTINUE? 

Iftheusertypes"YES"totheCONTINUE?query, SYSLOAD 
will proceed and effectively erase each area that has moved. 
A"NO" input is allowed in the event that the user made an 
error in allocating the RAD areas on the :DEVICE command 
and does not wish to proceed. Fora "NO" input, SYSLOAD 
will output the map, if requested, and then enter a "WAIT" 
condition. Note that since SYSLOAD must read in the RAD 
Bootstrap of the existing version to find the RAD location of 
the Master Directory, the starting track of the System RAD 
must be identical in both versions for the "UPD" option to 
be used. 

The RELOAD, SP AREA alarm would also be output if the 
new version of the Monitor occupied more or less RAD space 
than the existing version. Since the Monitor is the first file 
in the area, all other files have to be moved and reloaded 
if the new Monitor requires a different amount of RAD space. 
In this case, the user must reload the entire SP area in the 
same manner as in an initial system load. The Monitor nor- 
mally does not overflow its allocated RAD space when a new 
version is loaded, since RAD space is allocated up to the 
starting address of background. 

If the first word address of background is different in a new 
version from that of the existing version, the alarm 



RELOAD, BGKG, PROGRAMS 



is output. All programs that execute in the background, 
both System Processors and user background programs, would 
then have to be reloaded and absolutized for their new core 
execution location. 

If SYSLOAD determines that the new version is completely 
compatible with the existing version, the message 



RELOAD, NOTHING 



is output. 



SYSLOAD 
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After typing the necessary RELOAD alarms, SYSLOAD loads 
the resident optional routines, the resident Monitor, and the 
RBM Overlays as described under the ALL option. 

RAD ALLOCATION OF SP AREA 

When SYSLOAD has executed, the Systems Program area of 
the RAD will have the following layout: 



SP Directory 

Entries for RBM, BOOT 



RBM File 

(Resident Monitor and RBM 

Overlays) 



BOOT FiU 



Unused SP AREA 



Relative sector 



Sectors 1 - n 



Sector n + 1 



Sectors (n + 2) - (n + m) 



SYSGEN AND SYSLOAD ALARMS 

All alarm messages that can be output during SYSGEN and 
SYSLOAD are defined in Table 19. 



LOADING SYSTEM PROCESSORS AND 
USER PROGRAMS 

After SYSLOAD completes its operation it will type the 
message 



SIGMA 5/7 RBM-2 VERSION XXXX 



and executes a WAIT instruction. The operator should then 
place his job stack in the C device to load the appropriate 
programs, perform an interrupt, and key in a "C". Control 
will be transferred to the Job Control Processor to read the 
first control command. 

If the "ALL" option was input to SYSLOAD, or if the SP 
AREA or BCKG PROGRAMS need reloading, the RAD Editor 
must be the first processor loaded. The RAD Editor should 
be loaded by the JCP Loader onto the OV file. The user 
then inputs control commands to the RAD Editor to define 
permanent RAD files for all system processors (including the 
RAD Editor), libraries, and all user programs. The RAD 
Editor can then be copied from the OV file onto its perma- 
nent file via the RAD Editor COPY command. The Overlay 
Loader should be the next processor loaded by the RBM 
Loader onto its defined file, and this loader can then be 
used to load all other processors and user programs. 

Typical examples for loading the RAD Editor and Overlay 
Loader, followed by a load of a system processor are illus- 
trated in Figures 19 and 20. 



Table 19. SYSGEN and SYSLOAD Alarm Messages 



Alarm 


Meaning 


Recovery Action 


BI CKSM ERR 


Non-I/O Alarms 

A checksum error has occurred in 
the object module being input. 


SYSLOAD will execute a "WAIT" instruction. If 
the computer is put back into RUN, the next rec- 
ord will be read from the BI input device. 


BI SEQ ERR 


A sequence error has occurred in 
the object module being input. 


Identical to "BI CKSM ERR". 


BT AREA TOO SMALL 


The space allocated to the BT area 
of the RAD is insufficient to hold the 
default sizes of the GO and OV files. 


There is no recovery from this condition except to 
rerun the SYSGEN to either allocate more RAD 
space for the BT area, or reduce the default size 
of the GO and/or OV file. 


CK AREA TOO SMALL 


The amount of RAD space allocated 
for the CK area is not sufficient to 
hold the initial size of background. 


Either the RAD areas must be reallocated (requires 
a rerun of SYSGEN) or a checkpoint cannot be 
done with the initial size of background. 


DUP. DEF,xxxxxxxx 


The same DEF has been encountered 
in two object modules, probably in- 
dicating that two copies exist of the 
same object module. 


Identical to "ERR, CONTROL BYTE =xx". 


EOF BEFORE END ITEM 


During the loading of an object mod- 
ule, SYSLOAD has encountered a 
misplaced EOD or EOF. 


SYSLOAD will enter a "WAIT" condition. If the 
computer is put back into RUN, the EOD or EOF 
will be ignored and the next record will be input. 
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Table 19. SYSGEN and SYSLOAD Alarm Messages (cont. 



Alarm 


Meaning 


Recovery Action 


ERR, CONTROL BYTE =xx 


Non-I/O Alarms (cont. ) 

The xx control byte in the object 
module being loaded cannot be 
processed by SYSLOAD. 


SYSLOAD will execute a "WAIT" instruction. If 
the computer is put back into RUN, the current 
object module will be bypassed and not loaded. 


ERROR ITEM xx 


An error has occurred in item xx 
of the last control command input. 
Every item (except the :), followed 
by a blank or a comma, is counted 
in determining the one in error. 
If xx is one greater than the last 
item input, a nonopfional item 
was not input. 


Control will be transferred to TYA01 to allow the 
user to correct the error. Unless stated otherwise 
(where the individual commands are described) all 
items preceding the incorrect one have been pro- 
cessed, and only items starting with and following 
the incorrect one need be input. If the user de- 
sires to input nothing from TYA01 and to transfer 
control back to the original input device, a single 
colon (:) should be input on TYA01. If an error 
occurs on a continuation card, a card containing 
a control command must follow. 


ILL. DEF, xxxxxxxx 
ILL. REF, xxxxxxxx 


The specified DEF or REF is not 
recognized by SYSLOAD during 
the loading of an object module. 


SYSLOAD will enter a "WAIT" condition. If the 
computer is put back into RUN, processing of the 
current object module will continue. 


INPUT ORDER ERROR 


The :MONITOR, :RE SERVE, or 
:DEVICE command for the System 
RAD has been input in the wrong 
order. 


Catastrophic error. Rerun SYSGEN from the start. 


MISSING ID 


See ALL option. 


See ALL option. 


NO SYSTEM RAD 


No RAD has been designated as 
the System RAD. 


Catastrophic error. SYSGEN must be rerun from 
the start. 


OBJ. MOD. NOT RECOG. 


The current object module being 
loaded by SYSLOAD is not recog- 
nized by SYSLOAD. 


Identical to "ERR, CONTROL BYTE =xx". 


OC LABEL NOT ASSIGNED 


The OC operational label has not 
been assigned toa typewriter device. 


There is no recovery from this error. The OC label 
must be assigned in order for the system to function. 


RAD OVERFLOW 


The total number of tracks input 
on the :DEVICE command have 
exceeded the total available size. 


The :DEVICE command must be completely reinput, 
with the sizes of the areas appropriately changed. 


RELOAD 

SP AREA 

FP AREA 

BP AREA 

Dn AREA 

XA AREA 

BCKG. PROGRAMS 

NOTHING 


See UPDATE option. 


See UPDATE option. 


TYPE C - OR - E 


This message is output after each 
object module when RBM is 
being loaded from paper tape 
to allow the user to load a 
new paper tape for each ob- 
ject module. 


Type "C" to continue if this is not the last object 
module to be input; or "E" (meaning EOD) if this 
is the last object module. 
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Table 19. SYSGEN and SYSLOAD Alarm Messages (cont.) 



Alarm 


Meaning 


Recovery Action 


UNABLE TO FIND OLD RBM 


Non-l/O Alarms (cont. ) 


SYSLOAD will continue with the load, but will be 
unable to make any checks as to which areas need 
reloading. The user must reload the entire SP area 
of the RAD if this alarm is output. 


During an update run, SYSLOAD 
was unable to locate the old ver- 
sion of RBM on the RAD. 


yyndd BUSY 
IOP n BUSY 


I/O Alarms 

The indicated device or IOP has 
returned a busy status. 


SYSGEN will keep attempting the I/O operation. 
Probably indicates a hardware problem. 


yyndd ERROR, SB = xxxx 
yyndd PARITY, TRK = xxxx 


A transmission error has occurred with 
the indicated device. SB = xxxx 
indicates the contents of the TIO 
status bytes in hexadecimal. If 
a parity occurs while clearing 
the RAD, the bad track, as re- 
turned in the sense order, is also 
logged in hexadecimal. 


SYSGEN continues attempting the I/O operation, 
unless a parity has occurred while clearing the 
RAD. In this case, this alarm and the parity alarm 
will be logged and the RAD clearing will continue. 


yyndd FAULT, 
TDV = xxxx 


A hardware fault has occurred on 
the indicated device. The TDV 
status byte is also output in 
hexadecimal. 


SYSGEN continues attempting the I/O operation. 
Repair and ready the indicated device. 


yyndd MANUAL 


The indicated device is in manual 
mode. 


Ready the device. 


yyndd UNRECOG 


The device indicated by yyndd is 
unrecognized by the system. 


SYSGEN will enter a "WAIT" state. Probably an 
invalid device number was input, and the 
SYSGEN will have to be rerun from the start. If 
the "WAIT" state is cleared, SYSGEN will retry 
the I/O operation. 


yyndd UNUS. END, 
TDV = xxxx 


An unusual end status has been 
returned from the indicated de- 
vice. The TDV status byte is also 
logged in hexadecimal. 


SYSGEN continues attempting the I/O operation. 


yyndd WRT PROT 


The indicated magnetic tape or 
RAD is hardware write-protected. 


For a magnetic tape, insert a write ring and ready 
the tape. For a RAD, reset the hardware Write 
Protect switch and then clear the "WAIT" state so 
SYSLOAD can retry the I/O operation. 
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IFIN 



!EOD 



Binary Deck (MAP Object-Module) 




!EOD 



Binary Deck (LIB Object Module) 




!EOD 



A 



1 



Binary Deck (DIAG ObjecrModule) 



!EOD 



Binary Deck (PAS2 Object Module) 




!EOD 



Binary Deck (PAS1 Object Module) 




!ECD 



Binary Deck (Root Object Module) 




!(OUT,SP,OLOAD) 



!LOAD MAP,(SEG,6),(IN,CRA03), ; 



| :(FSIZE,160) 



/ 



:ALLOT (FILE,SP,OLOAD),; 



: (FILE,SP,RADEDIT) 



:COPY (FILE,BT,OV), 



:(F SIZE, 100) 



:ALLOT (FILE,SP,RADEDIT), ; 



!ROV 



!EOD 



RAD Editor Object Module Deck 




ILOAD MAP, (CRA03) 



(PAUSE KEY-IN SYC 



UOB 



f 



Figure 19. Loading RAD Editor and Overlay Loader Processors Into System 
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!F1N 



A 



Binary Deck (PASS2 Object Modu le) 



:SEG (LINK,3),(DEV,CRA03) 



Binary Deck (PASS1 Object Module) 



:5EG (LINK, 2), (DEV,CRA03) 



I Binary Deck (IN1T Object Module) N 

:SEG (LINK,1),(DEV,CRA03) \ 



/k 



Binary Deck (ROOT Object Module) 




:ROOT (DEV,CRA03) 



:(FILE,SP,MACRSYM),LIB 



IOLOAD (MAP, ALL), ; 



:(FSIZE,100) 



:ALLOT (FILE,SP,MACRSYM), ; 



1RADEDIT 

| ! PAUSE KEY-IN SYC 



!JOB 



J/ 



Figure 20. Loading Macro- Symbol Processor Into System 
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APPENDIX A. SIGMA STANDARD OBJECT LANGUAGE 



INTRODUCTION 

GENERAL 

The XDS Sigma standard object language provides a means 
of expressing the output of any Sigma processor in standard 
format. All programs and subprograms in this object format 
can be loaded by the Monitor's relocating loader. Such a 
loader is capable of providing the program linkages needed 
to form an executable program in core storage. The object 
language is designed to be both computer-independent and 
medium-independent; i.e., it is applicable to any XDS 
Sigma computer having a 32-bit word length, and the same 
format is used for both cards and paper tape. 



SOURCE CODE TRANSLATION 

Before a program can be executed by the computer, it must 
be translated from symbolic form to binary data words and 
machine instructions. The primary stages of source program 
translation are accomplished by a processor. However, under 
certain circumstances, the processor may not be able to trans- 
late the entire source program directly into machine lan- 
guage form. 

If a source program contains symbolic forward references, a 
single-pass processor such as the XDS Symbol assembler can 
not resolve such references into machine language. This is 
because the machine language value for the referenced sym- 
bol is not established by a one-pass processor until after the 
statement containing the forward reference has been 
processed. 

A two-pass processor, such as the XDS Meta-Symbol assem- 
bler, is capable of making "retroactive" changes in the 
object program before the object code is output. There- 
fore, a two-pass processor does not have to output any 
special object codes for forward references. An example 
of a forward reference in a Symbol source program is given 
below. 



Y EGU $ + 3 

CI,5 Z 

LI,R Z 

Z EQU 2 

BG Z 

R EQU Z + 1 



In this example the operand $ + 3 is not a forward reference 
because the assembler can evaluate it when processing the 
source statement in which it appears. However, the oper- 
and Z in the statement 

CI,5 Z 

is a forward reference because it appears before Z has been 
defined. In processing the statement, the assembler outputs 
the machine-language code for CI, 5, assigns a forward ref- 
erence number (e.g., 12) to the symbol Z, and outputs that 
forward reference number. The forward reference number 
and the symbol Z are also retained in the assembler's symbol 
table. 

When the assembler processes the source statement 



LI, R 



it outputs the machine-language code for LI, assigns a for- 
ward reference number (e.g., 18) to the symbol R, outputs 
that number, and again outputs forward reference number 
1 2 for symbol Z. 

On processing the source statement 

Z EQU 2 

the assembler again outputs symbol Z's forward reference 
number and also outputs the value, which defines symbol Z, 
so that the relocating loader will be able to satisfy refer- 
ences to Z in statements CI, 5 Z and LI, R Z. At this time, 
symbol Z's forward reference number (i.e., 12) may be 
deleted from the assembler's symbol table and the defined 
value of Z equated with the symbol Z (in the symbol table). 
Then, subsequent references to Z, as in source statement 



BG 



would not constitute forward references, since the assembler 
could resolve them immediately by consulting its symbol 
table. 

If a program contains symbolic references to externally 
defined symbols in one or more separately processed subpro- 
grams or library routines, the processor will be unable to 
generate the necessary program linkages. 

An example of an external reference in a Symbol source pro- 
gram is shown below. 

REF ALPH 



LI, 3 



ALPH 



When the assembler processes the source statement 
REF ALPH 
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it outputs the symbol ALPH, in symbolic (EBCDIC) form, in 
a declaration specifying that the symbol is an external ref- 
erence. At this time, the assembler also assigns a declara- 
tion name number to the symbol ALPH but does not output 
the number. The symbol and name number are retained in 
the assembler's symbol table. 

After a symbol has been declared an external reference, it 
may appear any number of times in the symbolic subprogram 
in which it was declared. Thus, the use of the symbol 
ALPH in the source statement 



LI, 3 



ALPH 



in the above example, is valid even though ALPH is not 
defined in the subprogram in which it is referenced. 

The relocating loader is able to generate interprogram link- 
ages for any symbol that is declared an external definition 
in the subprogram in which that symbol is defined. Shown 
below is an example of an external definition in a Symbol 
source program. 

DEF ALPH 

LI, 3 ALPH 



for their representation, depending on the type and specific 
content of each item. A group of 108 bytes, or fewer, com- 
prises a logical record. A load item may be continued from 
one logical record to the next. 

The ordered set of logical records that a processor generates 
for a program or subprogram is termed an "object module". 
The end of an object module is indicated by a module-end 
type code followed by the error severity level assigned to 
the module by the processor. 

RECORD CONTROL INFORMATION 

Each record of an object module consists of 4 bytes of con- 
trol information followed by a maximum of 104 bytes of load 
information. That is, each record, with the possible excep- 
tion of the end record, normally consists of 108 bytes of 
information (i.e., 72 card columns). 

The 4 bytes of control information for each record have the 
form and sequence shown below. 

Byte 



Record Type 


Mode 


Format 




1 1 


1 



ALPH AI,4 X'F2' 

When the assembler processes the source statement 

DEF ALPH 

it outputs the symbol ALPH, in symbolic (EBCDIC) form, in 
a declaration specifying that the symbol is an external defi- 
nition. At this time, the assembler also assigns a declaration 
name number to the symbol ALPH but does not output the 
number. The symbol and name number are retained in the 
assembler's symbol table. 

After a symbol has been declared an external definition it 
may be used (in the subprogram in which it was declared) in 
the same way as any other symbol. Thus, if ALPH is used as 
a forward reference, as in the source statement 



LI, 3 



ALPH 



above, the assembler assigns a forward reference number to 
ALPH, in addition to the declaration name number assigned 
previously. (A symbol may be both a forward reference and 
an external definition.) 

On processing the source statement 

ALPH Al,4 X'F2' 

the assembler outputs the declaration name number of the 
label ALPH (and an expression for its value) and also outputs 
the machine-language code for AI, 4 and the constantX'F2'. 

OBJECT LANGUAGE FORMAT 

An object language program generated by a processor is out- 
put as a string of bytes representing "load items". A load 
item consists of an item type code followed by the specific 
load information pertaining to that item. (The detailed format 
of each type of load item is given later in this appendix.) 
The individual load items require varying numbers of bytes 



Byte 1 



Sequence Number 




Byte 2 



Checksum 



Byte 3 



Record Size 



7 

Record Type specifies whether this record is the last 

record of the module: 

000 means last 

001 means not last 

Mode specifies that the loader is to read binary infor- 

mation. This code is always 11. 

Format specifies object language format. This code is 

always 100. 

Sequence Number is for the first record of the module 

and is incremented by 1 for each record thereafter, 
until it recycles to after reaching 255. 

Checksum is the computed sum of the bytes comprising 

the record. Carries out of the most significant bit 
position of the sum are ignored. 

Record Size is the number of bytes (including the record 

control bytes) comprising the logical record (5 < record 
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size £ 108). The recordsize will normally be 108 bytes 
for all records except the last one, which may be fewer. 
Any excess bytes in a physical record are ignored. 

LOAD ITEMS 

Each load item begins with a control byte that indicates the 
item type. In some instances, certain parameters are also 
provided in the load item control byte. In the following dis- 
cussion, load items are categorized according to their function: 

1. Declarations identify to the loader the external and 
control section labels that are to be defined in the 
object module being loaded. 

2. Definitions define the value of forward references, 
external definitions, the origin of the subprogram being 
loaded, and the starting address (e.g., as provided in 

a Symbol/Meta-Symbol END directive). 

3. Expression evaluation load items within a definition 
provide the values (such as constants, forward refer- 
ences, etc.) that are to be combined to form the final 
value of the definition. 

4. Loading items cause specified information to be stored 
into core memory. 

5. Miscellaneous items comprise padding bytes and the 
module-end indicator. 



DECLARATIONS 

In order for the loader to provide the linkage between subpro- 
grams, the processor must generate for each external refer- 
ence ordefinition a load item, referred to as a "declaration", 
containing the EBCDIC code representation of the symbol 
and the information that the symbol is either an external ref- 
erence or a definition (thus, the loader will have access to 
the actual symbolic name). 

Forward references are always internal references within an 
object module. (External references are never considered 
forward references.) The processor does not generate a dec- 
laration for a forward reference as it does for externals; how- 
ever, it does assign name numbers to the symbols referenced. 

Declaration name numbers (for control sections and external 
labels) and forward reference name numbers apply only within 
the object module in which they are assigned. They have no 
significance in establishing interprogram linkages, since 
external references and definitions are correlated by match- 
ing symbolic names. Hence, name numbers used in any 
expressions in a given object module always refer to symbols 
that have been declared within that module. 

The processor must generate a declaration for each symbol 
that identifies a program section. Although the XDS Symbol 
assembler used with the Monitor aliows only a standard con- 
trol section (i.e., program section), the standard object 
language includes provision for other types of control sec- 
tions (such as dummy control sections). Each object module 
produced by the Symbol processor is considered to consist of 
at least one control section. If no section is explicitly iden- 
tified in a Symbol source program, the assembler assumes it 
to be a standard control section (discussed below). The stan- 
dard control section is always assigned a declaration name 



number of 0. All other control sections (i.e., produced by 
a processor capable of declaring other control sections) are 
assigned declaration name numbers (1, 2, 3, etc.) in the 
order of their appearance in the source program. 

In the load items discussed below, the access code, pp, des- 
ignates the memory protection class that is to be associated 
with the control section. The meaning of this code is given 
below. 



PP 


Memory Protection Feature 


00 


Read, write, or access Instructions 


from. 


01 


Read or access instructions from. 




10 


Read only. 




11 


No access. 





Control sections are always allocated on a doubleword 
boundary. The size specification designates the number of 
bytes to be allocated for the section. 

Declare Standard Control Section 

Byte 



Control byte 












Byte 1 



Access code j 


Size (bits 1 through 4) 


P P 








1 

Byte 2 



Size (bits 5 through 12) 




Byte 3 



Size (bits 13 through 20) 



This item declares the standard control section for the object 
module. There may be no more than one standard control 
section in each object module. The origin of the standard 
control section is effectively defined when the first reference 
to the standard control section occurs, although the declara- 
tion item might not occur until much later in the object 
module. 



t„ 



Read" means a program can obtain information from the 
protected area; "write" means a program can store informa- 
tion into a protected area; and, "access" means the compu- 
ter can execute instructions stored in the protected area. 
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This capability is required by one-pass processors, since 
the size of a section cannot be determined until all of 
the load information for that section has been generated by 
the processor. 

D eclare Nonstandard Control Section 
Byte 







Control byte 



1 

Byte 1 



Access code 




Size (bits 1 through 4) 


P P 









Byte 2 



Size (bits 5 through 12) 




Byte 3 



Size (bits 13 through 20) 



7 

This item declares a control section other than standard con- 
trol section (see above). Note that this item is not applicable 
to the XDS Symbol processor used with the Monitor system. 
However, the loader is capable of loading object modules 
(produced by other processors, such as the Meta-Symbol 
and FORTRAN IV processors) that do contain this item. 

Declare Dummy Section 

Byte 



Control byte 








10 


1 




Byte 1 


1 


2 3 4 5 


6 7 


First byte of name number 





Byte 2 






7 


Second byte of name number' 





Byte 3 






7 


Access 


code 




Size (bits 


through 4) 


P 


P 








If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



Byte 4 






Size (bits 5 through 12) 





Byte 5 




7 


Size (bits 13 through 20) 





7 

This item comprises a declaration for a dummy control sec- 
tion. It results in the allocation of the specified dummy 
section, if that section has not been allocated previously 
by another object module. The label that is to be associ- 
ated with the first location of the allocated section must be 
a previously declared external definition name. (Even 
though the source program may not be required to explicitly 
designate the label as an external definition, the processor 
must generate an external definition name declaration for 
that label prior to generating this load item.) 

Declare External Definition Name 



Byte 



Control byte 














1 


1 



Byte 1 


1 


2 


3 4 5 


6 


7 


Name length, in bytes (K) 





Byte 2 










7 


First byte of name 





Byte K+l 










7 


Last byte of name 





This item declares a label (in EBCDIC code) that is an exter- 
nal definition within the current object module. The name 
may not exceed 63 bytes in length. 

Declare Primary External Reference Name 
Byte 



Control byte 








1 





1 



Byte 1 


1 


2 3 4 5 


6 


7 


Name length (K), in bytes 
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Byte 2 



First byte of name 



Byte K+l 



Last byte of name 



7 

This item declares a symbol (in EBCDIC code) that is a pri- 
mary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A primary external reference is capable of causing the loader 
to search the system library for a corresponding external 
definition. If a corresponding external definition is not 
found in anotherload module of the program or in the system 
library, a load error message is output and the job is errored. 

Declare Secondary External Reference Name 

Byte 



Control byte 















1 



Byte 1 






Name length, in bytes (K) 





Byte 2 




7 


First byte of name 






Byte K+l 



Last byte of name 



7 

This item declares a symbol (in EBCDIC code) that is a sec- 
ondary external reference within the current object module. 
The name may not exceed 63 bytes in length. 

A secondary external reference is notcapable of causing the 
loader to search the system library for a corresponding exter- 
nal definition. If a corresponding external definition is not 
found in another load module of the program, the job is not 
errored and no error or abnormal message is output. 

Secondary external references often appear in library routines 
that contain optional or alternative subroutines, some of which 
may not be required by the user's program. By the use of pri- 
mary external references in the user's program, the user can 
specify that only those subroutines thatare actual ly required by 
the current job are to be loaded. Although secondary external 
references do not cause loading from the library, they do cause 
linkages to be made between routines that are loaded. 



DEFINITIONS 

When a source language symbol is to be defined (i.e., equa- 
ted with a value), the processor provides for such a value by 
generating an object language expression to be evaluated by 
the loader. Expressions are of variable length, and termi- 
nate with an expression-end control byte (see Section 4 of 
this appendix). An expression is evaluated by the addition 
or subtraction of values specified by the expression. 

Since the loader must derive values for the origin and start- 
ing address of a program, these also require definition. 



Ori 



gin 



Byte 












Control byte 











1 













1 



This item sets the loader's load-location counter to the 
value designated by the expression immediately following 
the origin control byte. This expression must not contain 
any elements that cannot be evaluated by the loader (see 
Expression Evaluation which follows). 

Forward Reference Definition 



Byte 










Control byte 








10 









Byte 1 


1 


2 3 4 5 


6 


7 


First byte of reference number 





Byte 2 








7 


Second byte of reference number 





7 

This item defines the vaiue (expression) for a forward refer- 
ence. The referenced expression is the one immediately 
following byte 2 of this load item, and must not contain 
any elements that cannot be evaluated by the loader (see 
Expression Evaluation which follows). 

Forward Reference Definition and Hold 

Byte 



Control byte 








10 









Byte 1 


1 


2 3 4 5 


6 


7 


First byte of reference number 





Byte 2 








7 


Second byte of reference number 
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This item defines the value (expression) for a forward refer- 
ence and notifies the loader that this value is to be retained 
in the loader's symbol table until the module end is encoun- 
tered. The referenced expression is the one immediately 
following the name number. It may contain values that have 
not been defined previously, but all such values must be 
available to the loader prior to the module end. 

After generating this load item, the processor need not retain 
the value for the forward reference, since that responsibility 
is then assumed by the loader. However, the processor must 
retain the symbolic name and forward reference number 
assigned to the forward reference (until module end). 

External Definition 



Byte 












Control byte 











1 





1 




Byte 



First byte of name number 




Byte 2 



Second byte of name number* 



This item defines the value (expression) for an external 
definition name. The name number refers to a previously 
declared definition name. The referenced expression is 
the one immediately following the name number. 

Define Start 

Byte 



Control byte 



1 







1 



This item defines the starting address (expression) to be used 
at the completion of loading. The referenced expression is 
the one immediately following the control byte. 



3. An external definition value. 

4. A forward reference value. 

5. A field definition value. 

Such expressions may include sums and differences of con- 
stants, addresses, and external or forward reference values 
that, when defined, will themselves be constants or addresses. 

After initiation of the expression mode, by the use of a con- 
trol byte designating one of the five items described above, 
the value of an expression is expressed as follows: 

1. An address value is represented by an offset from the 
control section base plus the value of the control sec- 
tion base. 

2. The value of a constant is added to the accumulated 
sum by generating an Add Constant (see below) control 
byte followed by the value, right-justified in fourbytes. 

The offset from the control section base is given as a 
constant representing the number of units of displace- 
ment from the control section base, at the resolution 
of the address of the item. That is, a word address 
would have its constant portion expressed as a count of 
the number of words offset from the base, while the 
constant portion of a byte address would be expressed 
as the number of bytes offset from the base. 

The control section base value is accumulated by means 
of an Add Value of Declaration (see below) or Subtract 
Value of Declaration load item specifying the desired 
resolution and the declaration number of the control 
section base. The loader adjusts the base value to the 
specified address resolution before adding it to the cur- 
rent partial sum for the expression. 

In the case of an absolute address, an Add Absolute 
Section (see below) or Subtract Absolute Section con- 
trol byte must be included in the expression to identify 
the value as an address and to specify its resolution. 

3. An external definition or forward reference value is 
included in an expression by means of a load item add- 
ing or subtracting the appropriate declaration or forward 
reference value. If the value is an address, the reso- 
lution specified in the control byte is used to align the 
value before adding it to the current partial sum for the 
expression. If the value is a constant, no alignment is 
necessary. 



EXPRESSION EVALUATION 

A processor must generate an object language expression 
whenever it needs to communicate to the loader one of 
the fol lowing: 

1. A program load origin. 

2. A program starting address. 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



Expressions are not evaluated by the loader until all required 
values are available. In evaluating an expression, the 
loader maintains a count of the number of values added or 
subtracted at each of the four possible resolutions. A sepa- 
rate counter is used for each resolution, and each counter 
is incremented or decremented by 1 whenever a value of the 
corresponding resolution is added to or subtracted from the 
loader's expression accumulator. The final accumulated sum 
is a constant, rather than an address value, if the final count 
in all four counters is equal to 0. If the final count in one 
(and only one) of the four counters is equal to +1 or -1, the 



126 Appendix A 



accumulated sum is a "simple address" having the resolution 
of the nonzero counter. If more than one of the four counters 
have a nonzero final count, the accumulated sum is termed 
a "mixed-resolution expression" and is treated as a constant 
rather than an address. 



Byte 3 



Third byte of constant 



The resolution of a simple address may be altered by means 
of a Change Expression Resolution (see below) control byte. 
However, if the current partial sum is either a constant or 
a mixed-resolution value when the Change Expression Reso- 
lution control byte occurs, then the expression resolution 
is unaffected. 

Note that the expression for a program load origin or start- 
ing address must resolve to a simple address, and the single 
nonzero resolution counter must have a final count of +1 
when such expressions are evaluated. 

In converting a byte address to a word address, the two least 
significant bits of the address are truncated. Thus, if the 
resulting word address is later changed back to byte resolu- 
tion, the referenced byte location will then be the first byte 
(byte 0) of the word. 

After an expression has been evaluated, its final value is 
associated with the appropriate load item. 

In the following diagrams of load item formats, RR refers to 
the address resolution code. The meaning of this code 
is given in the table below. 



Byte 4 



RR 


Address Resolution 


00 
01 
10 
11 


Byte 

Halfword 
Word 
Double word 



The load items discussed in this appendix, "Expression 
Evaluation", may appear only in expressions. 

Add Constant 



Byte 












Control byte 

















1 




Byte 1 



First byte of constant 



Byte 2 



Second byte of constant 



Fourth byte of constant 







7 



This item causes the specified 4-byte constant to be added 
to the loader's expression accumulator. Negative constants 
are represented in two's complement form. 

Add Absolute Section 



Byte 












Control byte 








1 


1 1 


R 


R 







1 



This item identifies the associated value (expression) as a 
positive absolute address. The address resolution code, RR, 
designates the desired resolution. 

Subtract Absolute Section 



Byte 














Control byte 








1 


1 1 





R 


R 







1 



This item identifies the associated value (expression) as a 
negative absolute address. The address resolution code, 
RR, designates the desired resolution. 

Add Value of Declaration 



Byte 












Control byte 








1 





R 


R 




Byte 



First byte of name number 



Byte 2 




Second byte of name number 





If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 
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This item causes the value of the specified declaration to be 
added to the loader's expression accumulator. The address 
resolution code, RR, designates the desired resolution, and 
the name number refers to a previously declared definition 
name that Is to be associated with the first location of the 
al located section. 

One such item must appear in each expression for a reloca- 
table address occurring within a control section, adding the 
value of the specified control section declaration (i.e. , 
adding the byte address of the first location of the control 
section). 

Add Value of Forward Reference 



Byte 










Control byte 








10 1 


R 


R 



The address resolution code, RR, designates the desired 
resolution, and the name number refers to a previously de- 
clared definition name that is to be associated with the 
first location of the allocated section. 

Subtract Value of Forward Reference 



Byte 










Control byte 








10 11 


R 


R 



Byte 1 



First byte of forward reference number 



Byte 1 



First byte of forward reference number 




Byte 2 



Second byte of forward reference number 







This item causes the value of the specified forward reference 
to be added to the loader's expression accumulator. The 
address resolution code, RR, designates the desired resolu- 
tion, and the designated forward reference must not have 
been defined previously. 

Subtract Value of Declaration 



Byte 












Control byte 








1 1 





R 


R 



Byte 1 




First byte of name number 






Byte 2 



Second byte of name number' 



This item causes the value of the specified declaration to 
be subtracted from the loader's expression accumulator. 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



Byte 2 



Second byte of forward reference number 







This item causes the value of the specified forward reference 
to be subtracted from the loader's expression accumulator. 
The address resolution code, RR, designates the desired reso- 
lution, and the designated forward reference must not have 
been defined previously. 



Change Expression Resolution 



Byte 












Control byte 








1 1 





R 


R 







1 



This item causes the address resolution in the expression to 
be changed to that designated by RR. 

Expression End 

Byte 



Control byte 



















1 



This item identifies the end of an expression (the value of 
which is contained in the loader's expression accumulator). 



LOADING 



Load Absolute 



Byte 



Control byte 








N 


N 


N 


N 
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Byte 1 



First byte to be loaded 



Byte NNNN 




Last byte to be loaded 





This item causes the next NNNN bytes to be loaded abso- 
lutely (NNNN is expressed in natural binary form, except 
that 0000 is interpreted as 16 rather than 0). The load loca- 
tion counter is advanced appropriately. 

Load Relocatable (Long Form) 



Byte 












Control byte 


1 





I Q 


C 


R 


R 



Byte 1 



First byte of name number 




Byte 2 



Second byte of name number* 







This item causes a 4-byte word (immediately following this 
load item) to be loaded, and relocates the address field 
according to the address resolution code, RR. Control bit 
C designates whether relocation is to be relative to a for- 
ward reference (C = 1) or relative to a declaration (C =0). 
Control bit Q designates whether a 1 -byte (Q = 1) or a 
2-byte (Q = 0) name number follows the control byte of 
this load item. 

If relocation is to be relative to a forward reference, the 
forward reference must not have been defined previously. 
When this load item is encountered by the loader, the load 
location counter can be aligned with a word boundary by 
loading the appropriate number of bytes containing all zeros 
(e.g., by means of a load absolute item). 

Load Relocatable (Short Form) 



Byte 












Control byte 


1 C 


D 


D D 


D 


D 


D 



If the module has fewer than 256 previously assigned name 
numbers, this byte is absent. 



This item causes a 4-byte word (immediately following this 
load item) to be loaded, and relocates the address field 
(word resolution). Control bitC designates whether reloca- 
tion is to be relative to a forward reference (C = 1) or rela- 
tive to a declaration (C = 0). The binary number DDDDDD 
is the forward reference number or declaration number by 
which relocation is to be accomplished. 

If relocation is to be relative to a forward reference, the 
forward reference must not have been defined previously. 
When this load item is encountered by the loader, the load 
location counter must be on a word boundary (see "Load 
Relocatable (Long Form)", above). 

Repeat Load 

Byte 







Control byte 



Byte 1 



First byte of repeat count 




Byte 2 



Second byte of repeat count 







This item causes the loader to repeat (i.e., perform) the 
subsequent load item a specified number of times. The 
repeat count must be greater than 0, and the load item to 
be repeated must follow the repeat load item immediately. 

Define Field 



Byte 








Control byte 











111 




Byte 1 



Field location constant, in bits (K) 




Byte 2 



Field length, in bits (L) 



7 

This item defines a value (expression) to be added to a field 
in previously loaded information. The field is of length L 
(1 i L S 255) and terminates in bit position T, where: 

T = current load bit position -256 +K. 
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The field location constant, K, may have any value from 
1 to 255. The expression to be added to the specified field 
is the one immediately following byte 2 of this load item. 



Padding 
Byte 



MISCELLANEOUS LOAD ITEMS 



Control byte 
























Byte 1 














Severity level 











E 


E 


E 


E 



This item identifies the end of the object module. The 
value EEEE is the error severity level assigned to the mod- 
ule by the processor (see "LOAD", in Chapter 2 of this 
manual). 



Padding bytes are ignored by the loader. The object lan- 
guage allows padding as a convenience for processors. 

Module End 



Byte 










Control byte 











1 1 


1 



OBJECT MODULE EXAMPLE 



The following example shows the correspondence between 
the statements of a Symbol source program and the string 
of object bytes output for that program by the assembler. 
The program, listed below, has no significance other than 
illustrating typical object code sequences. 



Example 



1 










DEF 


AA,BB,CC 


CC IS UNDEFINED BUT CAUSES NO 
ERROR 


2 










REF 


RZ,RTN 


EXTERNAL REFERENCES DECLARED 


3 


00000 






ALPHA 


CSECT 




DEFINE CONTROL SECTION ALPHA 


4 


000C8 








ORG 


200 


DEFINE ORGIN 


5 


000C8 


22000000 


N 


AA 


LI, CNT 





DEFINES EXTERNAL AA; CNT IS A 
FWD REF 


6 


000C9 


32000000 


N 




LW,R 


RZ 


R IS A FORWARD REFERENCE; 


7 








* 




- 


RZ IS AN EXTERNAL REFERENCE, AS 


8 








* 






.DECLARED IN LINE 2 


9 


00OCA 


50000000 


N 


RPT 


AH,R 


KON 1 


DEFINES RPT; R AND KON ARE 


10 








* 




i 


FORWARD REFERENCES 


11 


000CB 


69200000 


F 




BCS, 2 


BB 


' BB IS AN EXTERNAL DEFINITION 


12 








* 




1 


k USED AS A FORWARD REFERENCE 


13 


000CC 


20000001 


N 




AI,CNT 


1 


CNT IS A FORWARD REFERENCE 


14 


000CD 


680000CA 






B 


RPT 


RPT IS A BACKWARD REFERENCE 


15 


000CE 


68000000 


X 




B 


RTN 


RTN IS AN EXTERNAL REFERENCE 


16 


000CF 


0001 


A 


KON 


DATA, 2 


1 


DEFINES KON 


17 




00000003 




R 


EQU 


3 


DEFINES R 


18 




00000004 




CNT 


EQU 


4 


DEFINES CNT 


19 


000 DO 


224FFFFF 


A 


BB 


LI,CNT 


-1 


DEFINES EXTERNAL BB THAT HAS 


20 








* 




< 


ALSO BEEN USED AS A FORWARD 


21 








* 






REFERENCE 


22 


0OOC8 








END 


AA 


END OF PROGRAM 
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CONTROL BYTES (In Binary) 
Begin Record Record number: 



00111100 
00000000 
01100011 
01101100 



00000011 



00000011 



00000011 



00000101 



00000101 



00001010 

00000001 
00100000 

00000010 



00000100 
00000001 
00100000 

00000010 



01000100 
00000111 

00100110 
00000010 



Record type: not last, Mode binary, Format: object language. 
Sequence number 
Checksum: 99 
Record size: 108 



03020101 (hexadecimal code comprising the load item) 
Declare external definition name (2 bytes) Name: AA 

03020202 

Declare external definition name (2 bytes) Name: BB 

03020303 

Declare external definition name (2 bytes) Name: CC 

0502D9E9 

Declare primary reference name (2 bytes) Name RZ 

0503D9E3D5 

Declare primary reference name (3 butes) Name: RTN 

A0 1 1 00000320200002 

Define external definition 

Number 1 

Add constant: 800 X'320' 

Add value of declaration (byte resolution) 

Number 

Expression end 

040100000320200002 

Origin 

Add constant: 800 X'320' 

Add value of declaration (byte resolution) 

Number 

Expression end 

4422000000 

Load absolute the following 4 bytes: X'22000000' 

07EB0426000002 

Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 

Add value of forward reference (word resolution) 

Number 

Expression end 



Declaration number: 1 



Declaration number: 2 



Declaration number: 3 



Declaration number: 4 



Declaration number: 5 



Record control 
information not 
part of load item 



Source Line 1 



Source Line 2 



Source Line 5 



Source Line 4 



Source Line 5 



No object code is generated for source lines 3 (define control section) or 4 (define origin) at the time they are encountered. 
The control section is declared at the end of the program after Symbol has determined the number of bytes the program requires. 
The origin definition is generated prior to the first instruction. 
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8432000000 

10000100 Load relocatable (short form). Relocate address field (word resolution) 
Relative to declaration number 4 

The following 4 bytes: X'32000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 

CC50000000 
11001100 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 12 
The following 4 bytes: X' 50000000' 

07EB0426000602 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 6 
00000010 Expression end 

D269200000 
11010010 Load relocatable (short form). Relocate address field (word resolution) 

Relative to forward reference number 18 
The following 4 bytes: X'69200000' 

4420000001 
01000100 Load absolute the following 4 bytes: X' 20000001' 

07EB0426000002 
00000111 Define field 

Field location constant: 235 bits 

Field length: 4 bits 

Add the following expression to the above field: 
00100110 Add value of forward reference (word resolution) 

Number 
00000010 Expression end 

80680000CA 
10000000 Load relocatable (short form). Relocate address field (word resolution) 

Relative to declaration number 
The following 4 bytes: X'680000CA' 

8568000000 

10000101 Load relocatable (short form). Relocate address field (word resolution) 
Relative to declaration number 5 

The following 4 bytes: X'68000000' 

08 
00001000 Define forward reference (continued in record 1) 



► Source Line 6 



Source Line 9 



Source Line 1 1 



* Source Line 13 



" Source Line 14 



' Source Line 15 



Source Line 16 
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Begin Record Record number 1 



00011100 Record type: last, Mode: binary, Format: object language. 

00000001 Sequence number 1 

11101100 Checksum: 236 

01010001 Record size: 81 



Record Control 
Information 



00OCO1 00000 33C 200002 (continued from record 0) 

Number 12 
00000001 Add constant: 828 X'33C 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

42001 
01000010 Load absolute the following 2 bytes: X'OOOT 

080006010000000302 
00001000 Define forward reference 

Number 6 
00000001 Add constant: 3 X'3' 

00000010 Expression end 

080000010000000402 
00001000 Define forward reference 

Number 
00000001 Add constant: 4 X'4' 

00000010 Expression end 

OF00024100 
00001111 Repeat load 

Repeat count: 2 
01000001 Load absolute the following 1 bytes: X'00' 

0800 1 20 1 00000340200002 
00001000 Define forward reference 

Number 18 
00000001 Add constant: 832 X'340' 

Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

A020 1 00000340200002 
00001010 Define external definition 

Number 2 
00000001 Add constant: 832 X'340' 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 

44224FFFFF 
01000100 Load absolute the following 4 bytes: X'224FFFFF' 

0D0 100000320200002 
00001101 Define start 

00000001 Add constant: 800 X'320" 

00100000 Add value of declaration (byte resolution) 

Number 
00000010 Expression end 



Source Line 16 



Source Line 17 



Source Line 18 



Advance to Word 
Boundary 



' Source Line 19 



I 



Source Line 22 
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0B000344 
00001011 Declare standard control section declaration number: 

Access code: Full access. Size 836 X'344' 

0E00 
00001110 Module end 

Severity level: X'0' 

A table summarizing control byte codes for object language load items is given below. 



Object Code C 


ontrol Byte 




Type of Load Item 











Padding 








1 


Add constant 





1 





Expression end 





1 


1 


Declare external definition name 





1 





Origin 





1 


1 


Declare primary reference name 





1 1 





Declare secondary reference name 





1 1 


1 


Define field 





1 





Define forward reference 





1 


1 


Declare dummy section 





1 1 





Define external definition 





1 1 


1 


Declare standard control section 





1 1 





Declare nonstandard control section 





1 1 


1 


Define start 





1 1 1 





Module end 





1 1 1 


1 


Repeat load 


1 








Define forward reference and hold 


10 


R 


R 


Add value of declaration 


10 


1 R 


R 


Add value of forward reference 


10 


1 R 


R 


Subtract value of declaration 


10 


1 1 R 


R 


Subtract value of forward reference 


11 


R 


R 


Change expression resolution 


11 


1 R 


R 


Add absolute section 


11 


1 R 


R 


Subtract absolute section 


10 


N N N 


N 


Load absolute 


10 1 


Q C R 


R 


Load relocatable (long form) 


1 C D D 


D D D 


D 


Load relocatable (short form) 
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APPENDIX B. REAL-TIME PERFORMANCE DATA 



RESPONSE TO INTERRUPTS BY CENTRALLY 
CONNECTED TASKS 

Table B-l shows the time (in psec) used by the system to 
save the interrupted context and establish the interrupting 
task context. This time includes the XPSD in the interrupt 
location context and represents the total time between the 
interrupt becoming active and the start of execution of the 
first instruction in the task (assuming no interruption by a 
higher priority task). The minimum and maximum times 
reflect minimum and maximum memory overlap. 



I/O INTERRUPT 

Following successful completion of an I/O device access, 
the I/O interrupt will remain active for a maximum of 
90 psec, assuming that no higher priority interrupts have 
become active during this period. RBM never disables the 
interrupt system for longer than 100 psec. 



Upon clearing the I/O interrupt, the system proceeds with 
cleanup of the request at the priority level of the inter- 
rupted task. 

CONSOLE INTERRUPT 

The Console Interrupt remains active for less than 30 psec. 
During this time, a flag in the Control Task is set to indi- 
cate the occurrence of the interrupt and the Control Task 
interrupt is triggered. 

OVERLAY LOADING 

Overlay loading is accomplished with a negligible percent- 
age of total time devoted to non-l/O system activity. For 
example, on the Model 7202/7204 RAD, a 1400-word over- 
lay requires approximately 50 msec, assuming average la- 
tency (1 7 mils) and I/O transfer time of 34 msec. To this 
must be added the time waited to gain access to the RAD 
(time of request, if any in progress, plus the time of any 
higher priority requests). 



Table B-l. Times Required to Save Interrupted Context 



Registers 
Saved 


Times in 
psec 


Task interrupts back- 
ground with accounting 


Task interrupts system or fore- 
ground tasks with accounting 


No ac- 
counting 


4 


Min. 


39.0 


34.4 


30.8 


Max. 


42.2 


36.1 


32.4 


8 


Min. 


42.2 


37.6 


34.0 


Max. 


44.8 


39.7 


36.0 


16 


Min. 


48.6 


44.0 


40.4 


Max. 


52.0 


46.9 


43.2 


Times assume a Sigma 7 configuration without map. 
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APPENDIX C. RAD STORAGE REQUIREMENTS 



Assuming a Model 7202/7204 RAD, a rough approximation 
of the amount of RAD space required by the RBM system is 
60 tracks to store the Monitor plus the following processors: 

Macro-Symbol 

FORTRAN IV-H 

FORTRAN Math/Run-Time Library 

Symbol 

Overlay Loader 

RAD Editor 



The RAD areas used by the system require the following ap- 
proximate numbers of tracks: 



RAD Area 
System Programs 
Checkpoint 
Background Temp 



Number of Tracks 



50 



8 (assuming an 1 1 K background) 

45 (sufficient for a Macro- 
Symbol "assemble and go" of 
about a 7000 line source 
program) 



The size of the Background Temp area is highly dependent 
on a user's requirements. 
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APPENDIX D. JCP LOADER 



In addition to loading the Overlay Loader and RAD Editor 
into their respective files in the SP RAD area at SYSGEN 
time (see ! LOAD command in Chapter 2), the JCP Loader 
can be used to load some user programs. Within the restric- 
tions given below, both nonoverlaid and overlaid programs 
can be loaded onto the RAD for subsequent execution. 



FP area. The program will be loaded to execute at4100ii 
(EXLOC,41 00). The foreground program can consist of any 
number of object modules, but the last object module must 
be followed by an EOF. The object modules must obey the 
restrictions specified for the JCP Loader (see above). Note 
that an SY key-in must be in effect. 



LOADING NON-OVERLAID PROGRAMS 

1. The last object module in the program being loaded 
must be terminated by an !EOD command. Any num- 
ber of object modules can be loaded. 

2. The object module cannot contain any of the following 
load items: declare dummy section, declare secondary 
external reference name, forward reference definition, 
or add or subtract absolute section. The field (in a de- 
fine field load item) cannot cross a word boundary. 

3. FORTRAN compiled programs or programs assembled 
with basic Symbol, or programs using the LOCAL 
directive cannot be loaded with this Loader. 

4. Object modules being loaded cannot contain more than 
225 declaration name numbers. 

5. The JCP Loader creates the OVLOAD and DCB table 
and the M:SL DCB. The user must code the complete 
PCB except for the OVLOAD table address, the DCB 
table address, and the M:5L DCB address. The user 
must also code all DCBs (except M:SL), the Temp Stack 
and all other tables referenced in the PCB. 

6. The PCB must be the first data loaded in the root. 

Example: 

Load a nonoverlaid foreground program onto its permanent 
file: 

I LOAD (IN,9TA82),(OUT,FP,FCOPY),(EXLOC,4100),F 



This example loads a foreground program (indicated by F 
parameter) from a 9-track tape onto the FCOPY file in the 



LOADING OVERLAID PROGRAMS 

For loading a program with overlay segments, the above re- 
strictions plus the following restrictions apply: 

1. The only overlay structure allowed is a root plus one 
level of overlay. 

2. The root must be the first group of object modules 
loaded and must be terminated by an ! EOD command. 
Each group of object modules loaded after the root and 
terminated with an I EOD command will consist of one 
overlay segment and will be attached to the end of the 
root. Each overlay segment will be assigned a segment 
identification of 1 to n, where 1 is assigned to the first 
segment loaded, 2 assigned to the second segment 
loaded, etc. The segment identification is used in 
calling in an overlay segment at execution time. 

3. The number of overlay segments must be correctly stated 
on the ! LOAD command. 

For multisegment programs, the JCP Loader builds the 
OVLOAD table at the end of the root and allocates seven 
words for the M:SL DCB. The entry address for each over- 
lay is taken from the last encountered start item and placed 
in the OVLOAD table along with the load address, byte 
count, and segment identification. 

The JCP Loader writes the program in core image format onto 
the appropriate file. The addresses and names of all M: or 
F; DEFswill be used by the Loader to create the DCB table. 
The loaded program can be executed via the RUN,ROV, or 
Name command, depending upon which RAD file the pro- 
gram was loaded on. Note that the Loader never loads a 
program directly into core memory. The JCP Loader can be 
used to load foreground programs (which must obey the pre- 
viously stated restrictions) by using the EXLOC and F pa- 
rameters on the ! LOAD command. 
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APPENDIX E. SYSTEM PATCHING 



Modification of the resident RBM system (including all sys- 
tem tables), RBM overlays, and Job Control Processor can 
be performed at system boot time through patches defined 
on ! MODIFY control commands. Any number of ! MODIFY 
commands can be input, and the stack is terminated by a 
single ! END command. The system is notified that patching 
is to take place by sense switch settings that are set prior to 
RBM initialization. 

As each command is processed, the overlay is read into 
core, modified, and written out to the system RAD. Note 
that unused RAD space between the end of an overlay and 
the end of an overlay's file (that is, unused space on the 
last sector of an overlay) can be used for a patch area. 

INPUT OPTIONS 

The ! MODIFY control commands are input at system boot 
time during the RBM initialization. Sense switches 1, 2, 
and 3 are used to designate the input device as follows: 



Setting 

All off 

1 on; 2, 3 off 

2 on; 1, 3 off 

3 on; 1,2 off 



Meaning 

no patches 
input from C device 
input from OC device 
input from SI device 



Any other sense switch settings will result in an error mes- 
sage and the system will have to be rebooted. The switches 
must be set prior to booting in the system. 

COMMAND FORMATS 

In the IMODIFY control commands listed below, the 
brackets only indicate options available in the specification 
field and are not actually used in the MODIFY statements; 
the indicated parenthesis and commas are required. The 
general format for ! MODIFY commands is 

/[MODIFY (module,loc), value[R] 



module specifies one of the modules described be- 

low to be patched. 

loc specifies the initial hexadecimal location to 

be modified and is relative to the beginning of the 
named module (for ABS, loc is relative location 0). 



PATCH SYSTEM OVERLAY OR JCP 

/l MODIFY (OLAY,name,loc)[R]value[,[R]value,... [Rjvalue] 

where name can be one of the following: 

JCP (Job Control Processor) 

CKPT (Checkpoint Routine) 

FGL1 (Foreground Program) Releaser) 

FGL2 (Foreground Program Loader) 

ABEX (Abort/Exit Routine) 

KEY1 (Key-in Processor 1) 

KEY2 (Key-in Processor 2) 

PMD (Postmortem Dump Routine) 

BKL1 (Background Loader 1) 

BKL2 (Background Loader 2) 

PATCH SIMULATION ROUTINE 
/\ MODIFY (SROU, name, loc) [R]value[,[R]value... [Rjvalue] 

PATCH RBM MONITOR 

IMODIFY (RBM, loc), [R]value[,[R] value ...[Rjvalue] 

PATCH SYSTEM TABLES 

IMODIFY (ABS, loc), value[, value, .. . value] 

PATCH PATCH AREA 

IMODIFY (PATCH, loc), value 



!END COMMAND FORMAT 

The IMODIFY control command(s) must be followed by a 
terminating !END command with the form 



(\ END [RBM] 



where RBM indicates that the copy of RBM resident on the 
system RAD is to be replaced by the current version of RBM 
in core. 



value specifies the hexadecimal value to be inserted 

in the location. Successive values in successive 
locations. 

R is the relocation flag indicating that the address 

field of the value is to be relocated by adding the 
beginning address of the named module. 



SYSTEM PATCHING DIAGNOSTICS 

The diagnostic messages in Table E-l will be output on 
the OC device for a corresponding error in sense switch 
settings or ! MODIFY commands. There is no error re- 
covery. In all cases, the condition causing the mes- 
sage must be corrected and the system rebooted. 
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Table E-l. System Patching Diagnostics 



Message 


Meaning 


Action 


"INVALID SSW SETTING, REBOOT 


Switch 4 is set, or more than 
one switch is set. 


Correct and reboot system. 


! IERROR ITEM xxxx, REBOOT 


Illegal area, illegal simulation 
routine, illegal identifier, or 
missing syntax (e. g. , parenthesis 
or comma). 


Correct and reboot system. 


! 1PATCHING OUTSIDE OF SPECIFIED — [ 


Requested patch either exceeds or 
falls outside previously specified 
area. 


Correct and reboot system. 


L AREA, REBOOT 


! IPATCH AREA NOT ALLOCATED 


Patch area was not previously 
specified at SYSGEN time. 


Re-SYSGEN and reboot 
system. 
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7T device code, 9 
9T device code, 9 



BO operational label, 9, 18 
BRAD entry, 108 
buffer pool, 105 



abnormal returns, 36 

ABORT/EXIT routine, 97 

ABORT function, 51 

ABORT return, 48,45 

access methods, 29 

accounting services, 4 

action character, 26 

active foreground program, vii 

add constant, 127 

add value of declaration, 127 

add value of forward reference, 1 28 

addend value, vii 

address resolution, 127 

address resolution code, vii 

addressing files, 29 

AIO status, 30 

AL file, 17,4 

ALL map, 67, 87, 1 03 

ALL option, 1 14 

ALLOBT control command (Monitor), 14,8,28 

ALLOBT control command (SYSGEN), 1 1 3, 1 08 

ALLOT control command (Editor), 82,28 

ARM function, 52,48,49 

ASSIGN command created DCBs, 33 

ASSIGN control command (Loader), 62,56,64,77 

ASSIGN control command (Monitor), 9,8,10,11,28,32, 

33, 64, 77 
ATTEND control command (Monitor), 12,8,53,70,83 

B 

BA processor specification option, 1 8 

background, 1 

background area, vii 

Background Data area, 5, 107 

background devices, 15 

background IOQ table, 109 

background job stack, 23, 2 

background program, vii, 82 

Background Programs area (BP), 3,80,5, 10, 107 

background Temp area, 28,3,5, 10,14, 19,58, 107,108,112 

background Temp File, 1 9, 1 

batch processing, 2 

BDTRACK control command (Editor), 88,80 

BI operational label, 9 

binary input, vii 

binary object module, 59,56 

blank COMMON, 77,5,54,60,78 

block boundary, 29 

blocked files, 28,14,19,29,80 

blocking buffers, 13,19 



C key-in, 23 

C operational label, 9,24 

calling overlay segments, 78 

calling Public Library, 66 

calling RAD Editor, 82 

CAL1 instruction, 28 

card punch, 26 

card reader, 26 

CC control command (Monitor), 13,8 

CC key-in, 24,13 

centrally connected interrupt, vii 

centrally connected task, 45,31,135 

change expression resolution, 128 

channel designation codes, 10 

CHECK function, 37,28,38 

CHECK system, 29 

CHECKed operations, 38 

checkpoint, 48, vii, 4, 107 

CI operational label, 9,18 

CI NT key-in, 24 

CLEAR control command (Editor), 84 

CLOSE file, 37 

CLOSE function, 30,37 

CLOSE request, 30 

CN processor specification option, 18 

CO operational label, 9, 18 

COC key-in, 23 

COMMON control command (Loader), 60,56,77 

COMMON storage, 46,77 

completion status, 29 

compressed files, 29,3,39,80 

compressed input, 18,94 

compressed output, 18, 90, 94, 95 

compressed programs, 94 

compressing directory entries, 80 

computing library file sizes, 81 

CONNECT function, 51,46,48,49,78 

connecting tasks to interrupts, 48,2 

console interrupt, 135 

constructing library, 66 

control command, vii 

control message, vii 

control panel task, 23, 105 

COPY control command (Editor), 83,82,84 

core memory layout, 104, 105 

core memory requirements, 2 

core size, 1 10 

core storage area allocations, 78, 104 

CP device code, 9 

CPU options, 10,110 
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CR device code, 9 

CTINT control command (SYSGEN), 113 



D processor specification option, 18 
DAL control command (Monitor), 17,8 
data area, 80 
data areas 

background, 107,3 

foreground, 1 07, 3 
Data Control Block (DCB), 64, vii, 1 , 9, 28 
data files, 80 
DATA statement, 54 
date, 4,24 
D8 key-in, 25 
DC device code, 9 
DCB, 1,9,30,77 
DCB creation, 32 
DCB format, 33 
DCB table, 11 
DCBTAB, 47,64 
DCT, 28,108 

decimal arithmetic trap, 48,50 
decimal simulation routines, 105 
declaration, vii 
declaration number, vii 
declarations, 123 
DED key-in, 25 
dedicated device, 25 
dedicated memory, vii 
DEF/REF, 65,81,82,85 
DEF/REF linkage, 55 
define field, 129 
define files, 14 
DEFREF file, 65,80,81,83 
DELETE control command (Editor), 84 
DEVICE control command (SYSGEN), 111,107,112,115 
device control table, 108,28,111 
device controller, 29 
device dedication, 25 
device designation codes, 10 
device file mode, 42,108 
device requests, 29 
device type code, 110 
device type index, 30 
DF key-in, 25 
direct access, 29,30 
direct connection, 49 
direct I/O (IOEX), 31,5,25 
directly connected interrupt, vii 
directly connected tasks, 31 
DISABLE function, 52,49 
DISARM function, 52,48,49 
DM key-in, 25 
DO operational label, 9 
DSECT, 61,63 
DT key-in, 24 
dummy section, 124, vii 
Dump Accounting Log, 17 



Dump Background key-in, 25 
DUMP control command (Editor), 86 
Dump Foreground key-in, 25 
Dump Monitor key-in, 25 
Dumps, 23 

E 

EBCDIC data, 29 

EBCDIC file, 65,81,85 

ENABLE function, 52,49 

end record, vii 

end-action, 31 

end-of-file mark, 17 

End-Of-Message key, 23 

entry address, 65 

ENTRY keyword, 78 

entry pool, 29 

EOD control command (Monitor), 15,8,55,94,101 

EOD record, 38 

EOF, 17 

EQU directive, 19 

error conditions, 36 

error severity level code, vii 

EXCLUDE control command (Loader), 56,60,65 

execution location, vii 

execution time, 1 3 

EXIT function, 51 

EXIT return, 45,48 

EXIT routine, 31 

expression, vii 

expression end, 128 

expression evaluation, 125 

external definition, 65, vii, 124, 126 

external interrupt, 6 

external reference, 65, vii, 81 

external reference name, 124, 125 

F 

F4:COM, 77,78 

F:DCB, 77 

FFPOOL, 105 

FG key-in, 25 

FGC key-in, 25 

file allocation, 80 

file deletion, 80 

file directories, 80,5,81 

file format, 85 

file keyword, 67 

file organization, 28,42 

file positioning, 15 

file size, 28,80,81,86 

file truncations, 85 

FIN control command (Monitor), 15,8 

FIN control command (SYSGEN), 113 

fixed-point arithmetic trap, 48,50 

floating-point arithmetic trap, 48,50 

floating-point simulation, 106,110 

FMBOX, 110 

FMEM key-in, 25 
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foreground, 1 

foreground area, vii, 106, 107 

foreground blocking buffer, 110 

foreground execution time, 4 

foreground exit, 105 

foreground IOQ table, 109 

foreground job examples, 102 

foreground mailbox, 2,65, 110 

foreground memory, 25 

foreground overlay programs, 54 

foreground program, 2, vii, 3, 1 1, 13, 24,49, 82, 1 07 

Foreground Programs area (FP), 3,80, 10,24,65,81,102, 

1 03, 1 07 
foreground protection, 25 
foreground Root Loader, 45,49,50,106 
foreground service routines, 106 
foreground task, 47, vii, 2, 6 
Foreground Programs Directory, 4 
format control, 34 
forming Public Library, 66 
FORTRAN Blank COMMON, 65 
FORTRAN DCBs, 64 

FORTRAN H control command (Monitor), 8 
FORTRAN interface, 77 
FORTRAN operational labels, 32 
FORTRAN source deck, 96,97,101 
forward reference definition, 125 
forward reference number, vii 
FP:MBOX, 2,65,109 
FPT (see Function Parameter Table) 
FRAD entry, 108 
free entry pool, 29 
FSC key-in, 25 

Function Parameter Table (FPT), 1 , vii, 28, 30, 31, 38 
F4:COM, 75 



GDTRACK control command (Editor), 88,80 

GO file, 3, 19, vii, 11,16, 18, 19,28,32,56,93, 100, 101, 

107,108 
granule size, 29, vii, 28, 42, 80 



/O queueing, 29 
/O request, 29, 32 
/O start, 29,3,30 
/O system calls, 36 

die account, 15 

die state, vii 

NCLUDE control command (Loader), 60,56,65 

nput/output operations, 28 

nstallation control command, viii 

nstallation parameters, 104 

nterrupt, 2, 31, 106 

nterrupt connection, 48 

nterrupt control, 48,106 

nterrupt label, 24,31, 109 

nterrupt priority, 31,7 

nterrupt task, 65 

nterrupt, external, 6 

nterrupt, trigger, 24 
interrupts 
ARM, 24 
DISARM, 24,49 
ENABLE, 24 
I/O, 7 
interrupts, disabling, 49 

INTLB control command (SYSGEN), 113,109 
INTLB key-in, 24 
INTLB table, 109 
INTTAB, 64 

IOEX function, 43, 5, 7, 25, 31 , 44, 1 06, 1 07 
IOP, 25 

IOP command doublewords, 31 
IOP multiplexor, 113 
IOP, selector, 113 

J 

JCP (see Job Control Processor) 

JCP Loader, 11,137 

JCP messages, 21,22 

job accounting, 4,53,106 

JOB control command (Monitor), 8, 9, 23, 32, 93 

Job Control Processor, (JCP), 8,4,19,28,54,106 



H 

hardware configuration, 6 
HIO instruction, 31 

I 

I/O cleanup, 29,3,4,30 

I/O codes, 36 

I/O communications, 25 

I/O device, 31,29,30 

I/O end action, 30 

I/O interrupt, 7,29-31,43, 106, 135 

I/O key -in, 26 

I/O messages, 26 

I/O package, 106 

I/O queue table, 109 



key-in, vii 

key-in processor, 106 

key-ins, 23 

C, 23 

CC, 24, 12 

CINT, 24 

COC, 23 

DB, 25 

DED, 25 

DF, 25 

DM, 25 

DT, 24 

FG, 13,25 

FGC, 25 

FSC, 25 
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FMEM, 25 
I/O, 26 
INTLB, 24 
RLS, 24 
RUN, 24,45 
SFC, 25 

STDLB, 24,32,75 
SY, 23 
SYC, 25 
TY, 23,25 
TYC, 25 
UND, 25 
W, 23 
X, 23 
keyword, viii 

L 

Labeled COMMON, 5,54,61,63,76-78 

LCOMMON control command (Loader), 61,56,77,78 

LIB control command (Loader), 59,56,60 

LIB option, 59 

library files, 81 

library input, viii 

library object modules, 54 

library protection, 66 

library search, 59 

LIMIT control command (Monitor), 13,8, 15 

LL operational label, 9 

LO operational label, 9,18 

load absolute, 128 

load and go operations, 93 

LOAD control command (Monitor), 11,8,46 

load foreground program, 24,45, 102 

load item, 123, viii, 130, 134 

load location counter, viii 

load map, viii 

load module, viii, 45 

load origin, 1 26 

load relocatable, 129 

Loader created DCBs, 33, 63 

Loader error diagnostics, 70 

Loader-generated items, 64 

loading system processors, 116 

loading user programs, 116 

logical device, viii 

LP device code, 9 

LS processor specification option, 18 

LU processor specification option, 18 

M 

M:BI system DCB, 32 
M:BO system DCB, 32 
M:C system DCB, 32 
M:CI system DCB, 32 
M:CO system DCB, 32 
M:DCB system DCB, 77 
M:DO system DCB, 32 
M:GO system DCB, 32 



M:LL system DCB, 32 

M:LO system DCB, 32 

M:OC system DCB, 32 

M:OV system DCB, 32 

M:PL, 32 

M:SI system DCB, 32 

M:SL system DCB, 32 

M-.SO system DCB, 32 

M:Xi system DCB, 32 

Macro-Symbol, 5,13,18,93 

Macro-Symbol processor load, 120 

MACRSYM control command (Monitor), 8,18,93,94 

magnetic tape, 27, 1 18 

manual mode, 16,26 

map, 67 

MAP control command (Editor), 85 

map information, 54 

Master Directory, 108 

MASTER function, 52 

master mode, 30, 47, 49 

math and run-time routines, 65 

memory area, 25 

memory protection, 4 

memory size, 1 1 

MESSAGE control command (Monitor), 8, 12 

modes (MOD,PACK), 42 

MODIFY control command (Loader), 61,56 

MODIFY control command (Monitor), 138, 15 

MODIR file, 65,81 

module directory file, 65,81,85 

module end, 130 

Monitor, viii, 2 

MONITOR control command (SYSGEN), 110 

Monitor control commands, 7 

ALLOBT, 14,8,28 

ASSIGN, 9,8,10,11,28 

ATTEND, 12,8,53,70,80 

CC, 13,8 

DAL, 17,8 

EOD, 15,8,55,94,101 

FIN, 15,8 

FORTRANH, 8 

JOB, 8,9,23,32,93 

LIMIT, 13,8,15 

LOAD, 11,8,46 

MACRSYM, 8,18,93,94 

MESSAGE, 8, 12 

MODIFY, 138,15 

OLOAD, 56,8,54,55,59,63 

PAUSE, 12,8,23 

PFIL, 15,8 

PMD, 15,8,93 

POOL, 13,8,19 

PREC, 15,8 

RADEDIT, 82,8 

REWIND, 16,8 

ROV, 13,8,18,45,93 

RUN, 13,8, 15,25,45,101 

SFIL, 16, 8 

SL-1, 5,8 
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STDLB, 13,8,13,32 

SYMBOL, 8 

UNLOAD, 16,8 

WEOF, 17,8 
Monitor errors, 36 
Monitor, SYSGEN options, 105 
multidevice controller, 31 



N 



name number, viii 
NEW LINE code, 23 
NO device code, 9 
nonstandard control section, 124 



object deck, viii 

object language, viii 

object language format, 122 

object module, viii, 11 

object module example, 130 

OC operational label, 9 

OLOAD control command (Monitor), 56,8,54,55,59,63, 

67,93 
OPEN function, 30,36,37 
OPEN request, 30 

operational label, 32, viii, 13, 24, 1 09, 1 12 
operator control, 23 
OPLBS table, 109 
option, viii 
origin, 125 
output devices, 30 

OV file, 3, 1 9, 1 1 , 1 3, 14,28, 93, 1 00, 1 07, 1 08 
Overlay control commands, 55 

ASSIGN, 62,56,64,77 

COMMON, 60,56,77 

EXCLUDE, 56,60,65 

INCLUDE, 60,56,65 

LCOMMON, 61,56,77,78 

LIB, 59,56,60 

MODIFY, 61,56 

PUBLIB, 63,56,59,61,62 

RES, 61,56 

ROOT, 57,54-56,58,59,66,78,101 

SEG, 58,54-56,59,61,66,100 
overlay example, 59 

Overlay Loader, 54, vii i, 5, 1 1 , 23, 28, 32, 45, 46, 93, 1 08 
Overlay Loader diagnostics, 70 
Overlay Loader processor load, 119 
overlay loading, 135 
overlay program, 54, viii, 55 
overlay segment, 12,5,47,48,64 
overlay structure, 54, 5, 6, 1 1 , 55 
OVLOAD, 63,5, 11,64 



P:END, 65,77 
padding, 130 



page boundary, 1 05 

paper tape punch, 27 

paper tape reader, 27 

parameter presence indicator, viii 

patching system, 138 

PAUSE control command (Monitor), 12,8,23 

PCB (see Program Control Block) 

permanent fi les, 2,28,80 

PFIL control command (Monitor), 15,8 

PFIL function, 41 

physical device, viii 

PL operation label, 34 

PMD control command (Monitor), 15,8,15,93 

POOL control command (Monitor), 13,8,19 

position file, 15, 41 

position record, 15,41 

postmortem dump, 15, viii, 6, 1 00, 1 06 

power failure, 26 

PP device code, 9 

PR device code, 9 

PREC control command (Monitor), 15,8 

primary reference, viii 

print error, 26 

PRINT function, 41 

printer, 26 

processor control commands, 17 

processor interface, 19 

program, 1 

Program Control Block (PCB), 46,2,5,47,64 

program deck, 93 

program file, 64 

PROGRAM map, 67,102 

PROGRAM map sample, 68 

program modification, 6 

program scheduling, 45 

program segments, 45 

Program Trap Conditions (PTC), viii 

protection violations, 4 

PSD, 49 

pseudo file name, viii 

PUBLIB control command (Loader), 63,56,59,61,62 

Public Library, 66,3,4,49,54,56,64,65 

PUNCH control command (SYSGEN), 113 

push down stack limit trap, 50 

push/pull stack instructions, 47 



queueing, 29 



RAD, 2 

RAD al location, 80, 5, 1 04, 1 06, 1 07, 1 1 6 

RAD areas, 3, 97, 105, 107, 136 

RAD bootstrap, 114,115 

RAD Editor, 80,5,23 

RAD Editor control commands, 82 

ALLOT, 82,28 

BDTRACK, 87,79 
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CLEAR, 84 
COPY, 83,82,84 
DELETE, 84 
DUMP, 86 
GDTRACK, 87,80 
MPA, 85 
RESTORE, 87 
SAVE, 87 
SQUEEZE, 85,84 
TRUNCATE, 85,81 
RAD Editor messages, 89 
RAD Editor processor load, 119 
RAD fi le, 4, 3, 9, 1 6, 23, 30, 32, 80, 1 06 
RAD File Directory, 42 
RAD Fi le Table (RFT), 28, 35, 42, 1 08, 1 1 1 
RAD map, 104 
RAD protection, 82 
RAD restoration messages, 89, 91 
RAD squeezing, 80 
RAD storage requirements, 1 36 
RAD tracks, 88, 99 
RAD, default sizes, 107 
RAD, write-protected, 118 
RADBOOT files, 115 
RADEDIT control command (Monitor), 82 
RBM Bootstrap, 1 07 
RBM Control Task, 4,6,23,106 
RBM files, 115 
RBM overlay area, 106 
RBM OVLOAD Table, 109 
RBM structure, 106 
RBM tables, 104,106 
RBMSAVE, 46 

READ function, 38 
read protection, 3 

READ request, 38,28-31 

real-time performance data, 135 

real-time processing, 2,97 

rebootable binary deck, 1 04, 1 06 

record control information, 122 

Record Size (RSZ), 28,42,80,86 

reentrant routine, 2,66 

REF, 65,104 

REF/DEF linkages, 5 

release foreground program, 25,45,50 

releasing Public Library, 65 

relocatable object module, 45, viii,58 

relocatable programs, 61 

repeat load, 1 29 

RES control command (Loader), 61,56 

RESERVE control command (SYSGEN), 110,108 

resident foreground program flag, 80 

resident program, viii 

restart, 48,2,3 

RESTORE control command (Editor), 88 

return functions, 48 

REWIND control command (Monitor), 16,8 

REWIND function, 40 

FRT(see RAD File Table) 

RLS function, 50 



13,8,18,45,93 
13,8,15,25,45,101 



RLS key-in, 24 

ROM (see Relocatable Object Module) 

root, 1 1,5, 54 

ROOT control command (Loader, 57,54-56,58,59,66,78,101 

Root Loader, 45,48,64, 106 

ROOT segment, 64 

ROOT substack, 56,61 

ROV control command (Monitor), 

RUN control command (Monitor), 

RUN function, 49 

RUN key-in, 24,45 

RUN system call, 45 

run-time ASSIGNS, 71 



SAVE control command (Editor), 88 

SAVE option, 14,19 

scheduling programs, 45 

scratch files, 19,99 

scratch storage, 2 

secondary reference, viii 

secondary storage, viii, 2 

SEG control command (Loader), 58,54-56,59,61,66,100 

SEGLOAD function, 52, 18,47,53-55,58,64,78 

segment linkage, 54 

Segment Loader, 32, viii, 106 

segment loading, 54 

segmented background job, 1 01 

segmented foreground program, 103 

selector IOP, 113 

sequential access, 29 

sequential input, 30,38 

severity level, 62 

SFC key-in, 25 

SFIL control command (Monitor), 16,8 

sharing DCBs, 30 

sharing I/O devices, 30 

sharing RAD files, 30 

SHORT map, 67,100 

SI operational label, 9,18 

signal address, 49,50 

SIO instruction, 31 

SIO operation, 43 

SIOP control command (SYSGEN), 113 

skip file, 16 

skipping bad tracks, 80 

SL-1, 5,8 

SL-1 control command (Monitor), 7 

SLAVE function, 52 

slave mode, 47,49 

SO operational label, 9,18 

software write protection, 4,23 

source code translation, 121 

source deck, viii 

source language, viii 

SQUEEZE control command (Editor), 85,84 

Stack Pointer Doubleword, 47 

stand-alone loader, 104,109 

standard control section, viii, 123 
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Standard Object Language, 121,54 

standard operational labels, 13 

starting address, 126 

STARTIO function, 31,42 

STDLB control command (Monitor), 13,8,32 

STDLB control command (SYSGEN), 112,109 

STDLB key-in, 24,32,77 

STOPIO function, 42,31 

subroutine, reentrant, 2 

SY key-in, 23 

SYC key-in, 25 

Symbol, 5, 108 

SYMBOL control command (Monitor), 8 

symbol table, 1 04 

symbolic name, viii 

SYSGEN, 104,108, 112 

SYSGEN control command (SYSGEN), 109 

SYSGEN control commands, 110 

ALLOBT, 113,108 

CTINT, 113 

DEVICE, 111, 107 

FIN, 113 

INTBL, 113, 109 

MONITOR, 110 

PUNCH, 113 

RESERVE, 110,108 

STOP, 113 

STDLB, 112,108 

SYSGEN, 109 

SYSLD, 114 
SYSGEN map, 105 
SYSGEN -defined parameters, 115 
SYSLD control command (SYSGEN), 114 
SYSLOAD, 114,104,115 
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